问题定位 FAQ 总览
什么时候读：你在使用昇腾时遇到报错或问题，想快速定位解决办法。
按问题类型选择
| 问题类型 | 典型报错 / 现象 | 进入 |
|---|---|---|
| 环境搭建类 | npu-smi 不识别、驱动装不上、CANN 报错、版本不配套 | 环境搭建类问题 |
| 训练类 | torch_npu 报错、OOM、loss 异常、分布式训练失败 | 训练类问题 |
| 推理类 | 服务起不来、请求错误、并发/显存问题 | 推理类问题 |
| 性能与精度 | 慢、吞吐低、精度不对、性能调优 | 性能与精度问题 |
通用排查步骤
无论哪种报错，先按以下顺序走一遍，能解决大部分问题：
- 看版本配套：CANN、框架、驱动、固件是否配套？（本仓库反复强调的坑）
- 看设备状态：
npu-smi info是否正常列出设备？ - 看环境变量：是否正确
source set_env.sh？（见 CANN） - 看日志：
dmesg、/var/log/npu/的 slog 日志报什么？ - 最小复现：用最小脚本/最小模型复现，缩小范围。
- 查官方文档/FAQ：昇腾官方文档中心、各开源项目的 FAQ 与 Issues。
收集报障信息模板（建议）
报障或提问时，带上这些信息会更快定位：
text
- 硬件型号 + NPU 数量：
- 操作系统 + 内核：
- 驱动固件版本：
- CANN 版本：
- 框架版本（torch/torch_npu/mindspore/engine）：
- 完整报错（日志关键段）：
- 复现步骤：TIP
大部分"装不上、跑不起来"都是版本不配套引起的。安装前务必确认配套表，见 环境搭建总览。