CANN环境变量速查手册安装配置、资源配置与故障收集的完整参考【免费下载链接】docs该仓库用于维护cann公共文档项目地址: https://gitcode.com/cann/docsCANN环境变量是昇腾AI开发中的核心配置手段。本手册基于 CANN 公共文档仓库的 环境变量参考 整理面向新手覆盖三大高频场景安装配置、资源配置与故障信息收集帮你快速完成环境配置并高效定位问题。 建议在应用进程拉起之前设置环境变量否则可能引起变量访问冲突导致程序异常详见 简介。一、安装配置相关环境变量环境一键配置安装 CANN 软件后系统默认通过set_env.sh脚本自动配置编译、执行所需的基础环境变量如 PATH、LD_LIBRARY_PATH、PYTHONPATH 等。进程结束后变量会自动失效可通过脚本一键重新配置# root 用户安装 Toolkit 时 source /usr/local/Ascend/cann/set_env.sh # 非 root 用户安装时 source ${HOME}/Ascend/cann/set_env.sh修改~/.bashrc加入上述内容并source ~/.bashrc即可永久生效。常用安装配置变量速查变量作用文档ASCEND_CACHE_PATH设置共享文件存储路径算子编译缓存 kernel_cache、AOE调优知识库 aoe_data支持多机共享ASCEND_CACHE_PATHASCEND_WORK_PATH设置单机独享文件存储路径日志、trace、Profiling 数据、算子调试文件等ASCEND_WORK_PATHASCEND_CUSTOM_OPP_PATH自定义算子运行时搜索路径多个路径用英文冒号分隔ASCEND_CUSTOM_OPP_PATHCANN_KNOWLEDGE_BANK_PROCESS_NUM知识库查询进程数取值 [0,8]默认 8进程越多编译越快但 Host 内存消耗越大CANN_KNOWLEDGE_BANK_PROCESS_NUM⚠️新手避坑提示ASCEND_CACHE_PATH指定的路径需已存在且执行用户有读、写、执行权限共享存储需支持 Linux 文件锁如 NFSv4。ASCEND_WORK_PATH的最后一段建议用machineID_vmID_dockerID拼接唯一标识当前机器物理机用 IP 即可。多服务器场景下各机器的 AI 处理器型号、固件驱动与 CANN 版本需保持一致。二、资源配置与算子执行管好设备与性能资源配置文件RESOURCE_CONFIG_PATH设置异构资源描述信息文件JSON含单节点及集群描述的存储路径适用于 Atlas A2 系列产品。文档RESOURCE_CONFIG_PATH更多设备可见性如ASCEND_RT_VISIBLE_DEVICES、内存使用类变量可参考 资源配置总览。算子执行相关变量变量作用文档ACLNN_CACHE_LIMIT配置 aclnn API 在 Host 侧缓存的算子信息条目数默认 10000动态 shape 范围大时可适当调大以提升调度性能但会增加 Host 内存开销ACLNN_CACHE_LIMITOP_PCIE_THROUGH_ACCESS_HOST_MEM_CHECK_ENABLEPCIe 穿透访问主机内存检查开关OP_PCIE_THROUGH_ACCESS_HOST_MEM_CHECK_ENABLE一般不建议修改ACLNN_CACHE_LIMIT保持默认值即可单算子缓存约 2KB/条融合算子约 20KB/条设置过大会挤占 Host 内存。三、故障信息收集变量快速定位问题的组合拳 遇到 AI Core 报错、算子异常时这 3 个变量是排障主力总览见 故障信息收集1. NPU_COLLECT_PATH指定故障信息保存路径复现问题时用它指定 dump 图、AI Core 算子异常数据、算子编译信息等故障信息的保存路径路径不存在会自动创建export NPU_COLLECT_PATH$HOME/demo/注意设置后默认自动开启异常算子 dump 采集模型编译时会改为在线编译算子om 文件会增大调试完成后请及时删除该变量。详见 NPU_COLLECT_PATH。2. ASCEND_DUMP_SCENE开启异常算子 Dump导出异常算子的输入输出数据、workspace 和 Tiling 信息支持三个档位aic_err_brief_dump轻量化 dump输入输出 workspaceaic_err_norm_dump普通 dump额外导出 Shape、Data Type、Format 及属性aic_err_detail_dump详细 dump额外导出 AI Core 内部存储、寄存器及调用栈A2/A3 系列支持export ASCEND_DUMP_SCENEaic_err_brief_dump 优先级提醒ASCEND_DUMP_SCENENPU_COLLECT_PATH 配置文件。详见 ASCEND_DUMP_SCENE。3. ASCEND_DUMP_PATH指定 Dump 存储路径export ASCEND_DUMP_PATH/repo/task001与异常算子 Dump 配合时路径优先级ASCEND_DUMP_PATHASCEND_WORK_PATH 当前执行目录单独设置该变量即可默认开启算子 Kernel 数据 Dump功能。文档ASCEND_DUMP_PATH四、延伸日志与性能采集变量日志配置日志路径、日志级别、Core Dump 等变量汇总见 日志如ASCEND_PROCESS_LOG_PATH、ASCEND_GLOBAL_LOG_LEVEL。性能数据采集PROFILING_MODE、PROFILING_OPTIONS等 msprof 性能采集变量见 性能数据采集采集数据落盘路径受ASCEND_WORK_PATH中的profiling_data/目录控制。集合通信多卡多机训练常用 HCCL 环境变量见 集合通信。总结场景首选变量安装后环境一键生效set_env.sh~/.bashrc统一文件落盘、多机共享缓存ASCEND_CACHE_PATH/ASCEND_WORK_PATH加载自定义算子ASCEND_CUSTOM_OPP_PATH加速算子编译CANN_KNOWLEDGE_BANK_PROCESS_NUM排障收集故障信息NPU_COLLECT_PATHASCEND_DUMP_SCENEASCEND_DUMP_PATH掌握这组 CANN 环境变量就能覆盖从环境安装到故障定位的全流程。更多完整清单请查阅 环境变量参考。【免费下载链接】docs该仓库用于维护cann公共文档项目地址: https://gitcode.com/cann/docs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考