---
title: ASCEND_CACHE_PATH
description: "若开发者期望编译运行过程中产生的文件落盘到统一路径，可通过此环境变量设置共享文件的存储路径，各组件编译运行过程中产生的可共享文件会存储到此环境变量定义的路径中。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/maintenref/envvar/envref_07_0006.html
sourcePath: /source/zh/canncommercial/900/maintenref/envvar/envref_07_0006.html
indexId: 4aefd2793e1c71fa0346591f38c1a9ad29a4b2706f7c6395565272e3a09f86cc67
---
# ASCEND_CACHE_PATH

#### 功能描述

若开发者期望编译运行过程中产生的文件落盘到统一路径，可通过此环境变量设置共享文件的存储路径，各组件编译运行过程中产生的可共享文件会存储到此环境变量定义的路径中。

- 路径支持大小写字母（a-z，A-Z）、数字（0-9）、下划线（_）、中划线（-）、句点（.）、中文字符。
- 需要确保指定的路径存在且有效，执行用户具有读、写、执行权限。

${ASCEND_CACHE_PATH}路径下的文件如下表所示。


**表1 共享文件落盘路径汇总**

| 落盘文件 | 文件内容 | 优先级说明 |
| --- | --- | --- |
| ${ASCEND\_CACHE\_PATH}/aoe\_data | AOE调优知识库文件。 支持多机共享。 | TUNE\_BANK\_PATH> ASCEND\_CACHE\_PATH> 默认知识库路径 关于默认知识库路径的说明，请参见TUNE\_BANK\_PATH中说明。 |
| ${ASCEND\_CACHE\_PATH}/kernel\_cache | 算子编译缓存文件。 支持单机多卡共享。 | 以下场景提供了设置算子编译缓存文件存储路径的参数或接口，其优先级高于ASCEND\_CACHE\_PATH环境变量，详细描述如下： 使用ATC工具进行离线模型编译的场景 参数“\-\-op\_compiler\_cache\_dir(https://www.hiascend.comdocument/detail/zh/canncommercial/900/devaids/atctool/atlasatcparam\_16\_0085.html)” > ASCEND\_CACHE\_PATH > 默认路径（$HOME/atc\_data） 使用AscendCL接口构建或编译模型的场景 构图接口“aclgrphBuildInitialize(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/ascendgraphapi/atlasgeapi\_07\_0142.html)”中参数“OP\_COMPILER\_CACHE\_DIR”> ASCEND\_CACHE\_PATH > 默认路径（$HOME/atc\_data） 构图接口“aclgrphBuildModel(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/ascendgraphapi/atlasgeapi\_07\_0143.html)”中参数“OP\_COMPILER\_CACHE\_DIR”> ASCEND\_CACHE\_PATH > 默认路径（$HOME/atc\_data） 应用编译接口“aclCompileOpt(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/ascendgraphapi/aclcppdevg\_03\_1371.html)”中编译选项“ACL\_OP\_COMPILER\_CACHE\_DIR” > ASCEND\_CACHE\_PATH > 默认路径（$HOME/atc\_data） TensorFlow网络训练或在线推理场景 TF Adapter配置参数“op\_compiler\_cache\_dir”> ASCEND\_CACHE\_PATH > 默认路径（$HOME/atc\_data）。 TF Adapter配置参数“op\_compiler\_cache\_dir”的详细说明可参见： 《TF Adapter接口 (1.x)(https://www.hiascend.com/document/detail/zh/TensorFlowCommercial/900/migration/tfmigr1/tfmigr1\_tfadapi\_0001.html)》中的“session配置 > session配置参数说明”。 《TF Adapter接口 (2.x)(https://www.hiascend.com/document/detail/zh/TensorFlowCommercial/900/migration/tfmigr2/tfmigr2\_tfadapi\_0001.html)》中的“npu.global\_options > 配置参数说明。 |


#### 配置示例

```
export ASCEND_CACHE_PATH=/repo/task001/cache
```


#### 使用约束

- 共享存储需要支持Linux文件锁（如NFSv4、OceanStor Pacific 9950和OceanStor Pacific 9550 ），对于不支持Linux文件锁的存储（如NFSv3），建议存储到本地目录。
- 多服务器场景下，各机器上的AI处理器型号以及固件驱动与CANN软件版本需要保持一致。


#### 支持的型号

Atlas 训练系列产品

Atlas 推理系列产品

Atlas A2 训练系列产品 / Atlas A2 推理系列产品

Atlas A3 训练系列产品 / Atlas A3 推理系列产品

Atlas 350 加速卡

Atlas 200I/500 A2 推理产品