Ascend C 环境检查
快速检查开发环境配置和 NPU 设备状态。
工作流程
环境检查
│
├─ NPU 设备检查
│ └─ npu-smi list / scripts/npu_info.sh
│
└─ CANN 环境检查
└─ scripts/check_env.sh
NPU 设备检查
快速命令
# 查看设备详细信息(包含设备列表)
npu-smi info
# 监控设备资源
npu-smi top
脚本工具
# 综合 NPU 信息(推荐)
bash scripts/npu_info.sh
详细命令参数见 npu_commands.md,npu-smi 不可用时的回退方案见 asys_commands.md
CANN 环境检查
# 完整环境检查(推荐)
bash scripts/check_env.sh
检查项
| 检查项 | 说明 | 必需 |
|---|---|---|
| ASCEND_HOME_PATH | CANN Toolkit 路径 | 是 |
| CANN 版本 | 检测版本号及运行时依赖基线 | 建议确认 |
| ASCEND_OPP_PATH | CANN Ops 路径 | 运行时必需 |
| 自定义算子包 | op_api 库 | 运行自定义算子必需 |
| CANN 工具 | msprof/cannsim | 可选 |
⚠️ 注意:官方环境变量为
ASCEND_HOME_PATH,不是ASCEND_HOME。部分旧文档或示例代码可能使用ASCEND_HOME,这是错误用法。
详细环境配置见 env_config_guide.md,版本配套关系见其中「CANN 版本兼容性」章节
诊断脚本
| 脚本 | 用途 |
|---|---|
scripts/npu_info.sh |
NPU 设备信息综合查询 |
scripts/check_env.sh |
CANN 环境配置检查 |
常见问题
- NPU 不可见:检查
npu-smi list是否能识别设备 - 算子运行失败:优先运行
check_env.sh检查环境配置 - 确认是否有进程占用 NPU:使用
npu-smi info -t usages -i <device_id>查看运行中的进程;注意空闲设备仍会有少量 HBM 被驱动占用(正常现象),不应误判为设备被占用
详细排查见 troubleshooting.md