---
title: 环境变量列表
description: "本手册描述开发者基于CANN构建AI应用和业务过程中可使用的环境变量。"
url: https://www.hiascend.com/document/detail/zh/CANNCommunityEdition/latest/maintenref/envvar/envref_07_0045.html
sourcePath: /source/zh/CANNCommunityEdition/920beta1/maintenref/envvar/envref_07_0001.html
indexId: 8b80753348950a6ea96ddc8edf61c6d30ae51cee8adea80e325e1ec9b355f40478
---
# 环境变量列表

本手册描述开发者基于CANN构建AI应用和业务过程中可使用的环境变量。

- 环境变量支持通过命令、接口、配置等方式实现，包括export命令、putenv/getenv/setenv/unsetenv/clearenv函数、os.environ、os.getenv等。建议用户在应用进程拉起前设置环境变量，否则可能引起环境变量访问冲突，导致程序异常。
- 集合通信相关环境变量请参见《HCCL集合通信库(https://www.hiascend.com/document/detail/zh/CANNCommunityEdition/920beta1/commlib/hcclug/docs/zh/user_guide/hccl_intro.md)》的“相关参考 > 环境变量参考”。
- AMCT相关环境变量请参见《AMCT模型压缩工具》的“附录 > 环境变量参考”。


#### 安装配置相关

| 环境变量 | 简介 |
| --- | --- |
| ASCEND\_CACHE\_PATH | 若开发者期望编译运行过程中产生的文件落盘到归一路径，可通过此环境变量设置共享文件的存储路径，各组件编译运行过程中产生的可共享文件会存储到此环境变量定义的路径中。 |
| ASCEND\_WORK\_PATH | 若开发者期望编译运行过程中产生的文件落盘到归一路径，可通过此环境变量设置单机独享文件的存储路径，各组件编译运行过程中产生的单机独享文件会存储到此环境变量定义的路径中。 |
| ASCEND\_CUSTOM\_OPP\_PATH | 用户自定义算子包安装路径。开发者编译生成的自定义算子包需要安装到指定路径下时，需要配置该路径。 |
| CANN\_KNOWLEDGE\_BANK\_PROCESS\_NUM | 用于设置知识库管理模块查询知识库的进程数。 |


#### 图编译

| 环境变量 | 简介 |
| --- | --- |
| DUMP\_GE\_GRAPH | 把整个流程中各个阶段的图描述信息打印到文件中，此环境变量控制dump图的内容多少。 |
| DUMP\_GRAPH\_LEVEL | 把整个图编译流程中各个阶段的图描述信息打印到文件中。 |
| DUMP\_GRAPH\_FORMAT | 控制需要生成的dump文件类型。 |
| DUMP\_GRAPH\_PATH | 指定DUMP图文件的保存路径，可配置为绝对路径或脚本执行目录的相对路径。 |
| OP\_NO\_REUSE\_MEM | 计算图在昇腾平台编译的过程中默认采用内存复用形式，在问题定位场景中，如果开发者怀疑是内存复用错误导致计算结果异常，可通过此环境变量指定为某算子单独分配内存。 |
| ASCEND\_ENGINE\_PATH | 单算子JSON文件转换成离线模型场景，如果希望模型转换时只使用TBE算子（不查找AI CPU算子，找不到TBE算子则报错），则需要使用该环境变量。 |
| MAX\_COMPILE\_CORE\_NUMBER | 此环境变量用于指定图编译时可用的CPU核数。 |
| MULTI\_THREAD\_COMPILE | 此环境变量用于控制模型转换时是否使用单线程编译。 |
| ENABLE\_NETWORK\_ANALYSIS\_DEBUG | TensorFlow训练场景下，计算图编译失败时默认会终止训练流程，不会继续向Device下发剩余的图。若开发者希望图编译失败时，不终止训练流程，允许TF Adapter持续向Device下发计算图，可通过设置该环境变量实现。 |


#### 算子编译

| 环境变量 | 简介 |
| --- | --- |
| TE\_PARALLEL\_COMPILER | 网络模型较大时，可通过配置此环境变量开启算子的并行编译功能。 |
| ASCEND\_MAX\_OP\_CACHE\_SIZE | 启用算子编译缓存功能时，可通过此环境变量限制某个AI处理器下缓存文件夹的磁盘空间的大小。 |
| ASCEND\_REMAIN\_CACHE\_SIZE\_RATIO | 启用算子编译缓存功能时，当编译缓存空间大小达到ASCEND\_MAX\_OP\_CACHE\_SIZE而需要删除旧的kernel文件时，系统需要保留缓存的空间大小比例，默认为50，单位为百分比。 |
| IGNORE\_INFER\_ERROR | 算子入图时，跳过算子原型交付件校验的开关。交付件包括shape推导等算子入图适配函数的实现。 |


#### 资源配置

| 环境变量 | 简介 |
| --- | --- |
| ASCEND\_DEVICE\_ID | 指定当前进程所用的AI处理器的逻辑ID。 |
| ASCEND\_RT\_VISIBLE\_DEVICES | 指定哪些Device对当前进程可见，支持一次指定一个或多个Device ID。通过该环境变量，可实现不修改应用程序即可调整所用Device的功能。 |
| AUTO\_USE\_UC\_MEMORY | 控制系统是否允许算子搬移数据不经过L2 Cache的功能。 |
| RESOURCE\_CONFIG\_PATH | 用于设置配置异构资源描述信息文件的存储路径。 |


#### 算子执行

| 环境变量 | 简介 |
| --- | --- |
| ACLNN\_CACHE\_LIMIT | 此环境变量用于配置aclnn API在Host侧缓存的算子信息条目个数。缓存的算子信息包含workspace大小、算子计算的执行器、Tiling信息等。 |


#### 图执行

| 环境变量 | 简介 |
| --- | --- |
| ENABLE\_DYNAMIC\_SHAPE\_MULTI\_STREAM | 计算图执行时，开启多流并发执行功能在一定场景下可提升网络性能。当前多流并发执行功能默认关闭，动态shape图模式场景下，若开发者想开启多流并发执行功能，可通过此环境变量开启。 |
| MAX\_RUNTIME\_CORE\_NUMBER | 训练与在线推理场景下，针对动态shape图模式执行的网络，可通过设置此环境变量开启图执行器（Host侧）的多线程任务调度。 |


#### AOE调优

| 环境变量 | 简介 |
| --- | --- |
| TUNE\_BANK\_PATH | 可通过此环境变量指定调优后自定义知识库的存储路径。 |
| REPEAT\_TUNE | 是否重新发起调优，此环境变量在开启子图调优或算子调优的场景下生效。 |
| AOE\_MODE | 在线推理与训练场景下，可通过此环境变量指定AOE调优模式。 |


#### 性能数据采集

| 环境变量 | 简介 |
| --- | --- |
| PROFILING\_MODE | 该环境变量用于控制是否开启Profiling功能。 |
| PROFILING\_OPTIONS | 训练或在线推理场景下，开发者可通过PROFILING\_OPTIONS环境变量配置Profiling配置选项。 |


#### 日志

| 环境变量 | 简介 |
| --- | --- |
| ASCEND\_PROCESS\_LOG\_PATH | 设置日志落盘路径。 |
| ASCEND\_SLOG\_PRINT\_TO\_STDOUT | 是否开启Host侧应用类日志打印。开启后，日志将不会保存在log文件中，而是将产生的日志直接打印显示。 |
| ASCEND\_GLOBAL\_LOG\_LEVEL | 设置应用类日志的日志级别及各模块日志级别，仅支持调试日志。 |
| ASCEND\_MODULE\_LOG\_LEVEL | 设置应用类日志的各模块日志级别，仅支持调试日志。 |
| ASCEND\_GLOBAL\_EVENT\_ENABLE | 设置应用类日志是否开启Event日志。 |
| ASCEND\_LOG\_DEVICE\_FLUSH\_TIMEOUT | 指定Device侧应用类日志回传到Host侧的延时时间。 |
| ASCEND\_HOST\_LOG\_FILE\_NUM | Ascend EP 场景下，设置应用类日志目录（plog和device\-id）下存储每个进程日志文件的数量。 |
| ASCEND\_COREDUMP\_SIGNAL | 设置trace处理的core dump信号量。 |
| ASCEND\_LOG\_SYNC\_SAVE | 指定日志拥塞处理方式。 |
| ASCEND\_TRACE\_RECORD\_NUM | 设置trace日志文件的老化规格，取值范围[10, 1000]。 |


#### 故障信息收集

| 环境变量 | 简介 |
| --- | --- |
| NPU\_COLLECT\_PATH | 在复现问题场景下，使用该环境变量指定故障信息（包括dump图、AI Core算子异常数据、算子编译信息等）的保存路径，可配置为绝对路径或相对路径（此处是相对执行程序或命令的路径），执行用户需对该路径具有读、写、可执行权限，若路径不存在，系统会自动创建该路径中的目录。 |
| ASCEND\_DUMP\_SCENE | 在复现问题场景时，使用该环境变量开启异常算子Dump，导出异常算子的输入输出数据、workspace信息和Tiling信息。 |
| ASCEND\_DUMP\_PATH | 指定异常算子Dump信息的存储路径，可配置为绝对路径或执行程序的相对路径。指定的路径支持大小写字母（a\-z，A\-Z）、数字（0\-9）、下划线（\_）、中划线（\-）、句点（.）、中文字符，执行用户需具有读、写、执行权限，若路径不存在，系统会自动创建该路径中的目录。不指定路径时，异常算子Dump信息默认存放在应用程序的当前执行目录。 |


#### 后续版本废弃环境变量

| 环境变量 | 简介 |
| --- | --- |
| GE\_USE\_STATIC\_MEMORY | 此环境变量用于配置网络运行时使用的内存分配方式。 |
| ENABLE\_ACLNN | 图编译时，通过设置该环境变量，可以决定在图执行时是否调用算子注册的host执行函数来实现host执行逻辑及kernel下发。 |