NPUSim 完整入门：从零搭建昇腾 NPU 仿真环境（Web IDE 与手动安装全解析）-平芜编程栈

NPUSim 完整入门：从零搭建昇腾 NPU 仿真环境（Web IDE 与手动安装全解析）

【免费下载链接】npu-simulatorNPUSim（全称NPU Simulator）是一款面向算子开发场景的SoC级芯片仿真工具，用于分析运行在AI仿真器上的AI任务在各阶段的精度和性能数据（如指令执行情况等）。该工具有助于用户进行深度性能调优，使研发人员在无法获取或芯片资源紧缺的情况下，也能获得与真实芯片几乎一致的验证效果和性能反馈。项目地址: https://gitcode.com/cann/npu-simulator

NPUSim（全称 NPU Simulator）是一款面向算子开发场景的昇腾 NPU 仿真工具，可在没有真实芯片的情况下，输出与真实硬件几乎一致的精度与性能数据。本文带你从零开始搭建昇腾 NPU 仿真环境，完整覆盖 Web IDE 一键接入与服务器手动安装两条路线，并附首次仿真与性能报告查看的实操步骤，是新手上手的完整指南。

为什么要用 NPU 仿真器？

芯片资源紧缺或拿不到板卡时，算子开发往往卡在"验证"环节。NPUSim 的价值在于：

精度仿真：输出 bit 级精度结果，完成算子精度验证
性能仿真：输出指令流水图，定位算子性能瓶颈
二进制兼容：同一 kernel 既可在仿真器上跑，也可在 AI 处理器上跑，仿真结论可直接迁移到实板

支持的运行环境（详见 README.md）：

项目	支持范围
CPU 架构	aarch64、x86_64
仿真目标芯片	Ascend 950 系列

安装方式怎么选：Web IDE vs 手动安装

项目提供两种搭建昇腾环境的方式，按需选择（完整说明见 quick_install.md）：

安装方式	特点	适用人群
Web IDE	一站式开发平台，在线环境预装驱动固件、CANN 软件包和 NPUSim，无需手动安装	没有服务器设备的开发者，推荐新手
手动安装	在自有服务器上按步骤安装 CANN 软件包	有服务器、想体验完整安装流程的开发者

方式一：Web IDE 零配置接入昇腾仿真环境

对于无昇腾设备的开发者，Web IDE 是成本最低的路径：打开浏览器即可获得可运行的昇腾环境，环境中已装好驱动固件、软件包和依赖，默认安装最新商用发布版的 CANN 软件包。

启动 CANNLab 云开发环境的步骤

进入 CANN 开源项目页面，单击CANNLab按钮，使用已认证的华为云账号登录（未认证则按页面提示注册）
根据页面提示创建并启动云开发环境，单击连接 > WebIDE进入一站式开发平台，源码资源默认位于/mnt/workspace目录

💡 整个流程无需任何本地配置，环境就绪后可直接跳到下面的编译安装步骤。

编译并安装 NPUSim 最新代码

Web IDE 已预装 CANN（含 NPUSim）。如需使用仓库最新代码，先克隆源码：

git clone https://gitcode.com/cann/npu-simulator.git

然后在项目根目录执行编译与覆盖安装（脚本见 build_wheel.sh）：

bash ./clear.sh && bash ./build_wheel.sh pip3 install dist/*.whl --upgrade -t /usr/local/Ascend/python/site-packages/

方式二：手动安装 CANN 环境全解析

适用于自有服务器的开发者，核心流程为：安装 CANN 软件包 → 编译安装 NPUSim → 验证生效。

安装 CANN toolkit 软件包

到 CANN 官方下载页面选择最新时间版本，按产品型号与环境架构下载对应包后执行安装：

chmod +x Ascend-cann-toolkit_${cann_version}_linux-${arch}.run ./Ascend-cann-toolkit_${cann_version}_linux-${arch}.run --install --install-path=${install_path}

参数说明：${arch}为 CPU 架构（aarch64 / x86_64），${install_path}为安装路径，root 用户默认/usr/local/Ascend。若算子运行依赖，可再按需安装 CANN ops 软件包（需与 toolkit 安装到相同路径）。

编译安装 NPUSim 并验证

CANN 包中已自带 NPUSim，如需覆盖为仓库最新代码：

bash ./clear.sh && bash ./build_wheel.sh pip3 install dist/*.whl --upgrade -t ${install_path}/python/site-packages/

两种方式安装完成后，统一用以下命令验证是否生效：

npusim --help

ℹ️ NPUSim 核心功能完全基于 Python 标准库实现，零第三方依赖，无需额外安装 Python 库。仅当运行内置性能样例的造数脚本时，才需要按需安装numpy。

首次仿真：3 条命令跑通 vector_add 示例

环境就绪后，用仓库内置的简易加法算子 vector_add 体验完整流程（详细步骤见 quick_start.md）：

# 1. 配置环境变量 source /usr/local/Ascend/cann/set_env.sh # 2. 编译算子 cmake -S tests/st -B build -DNPU_ARCH=dav-3510 && cmake --build build --target vector_add # 3. 执行仿真并自动生成报告 npusim record ./vector_add -s Ascend950 -g

仿真完成后，终端会打印Vector add completed successfully!，日志与报告输出在build/Samples/0_Introduction/vector_add/npusim_*/目录中。

查看性能报告：指令流水图与 VF IPC 报告

record模式生成的报告可进一步用 Perfetto 或 Chrome（chrome://tracing）打开trace_core0.json查看指令流水图，指令级时序一目了然：

若使用npusim record -s Ascend950 -g vf ./vector_add额外导出 VF 报告，还能得到各 VF 的 IPC 曲线，快速判断向量执行算力利用率（说明见 03_vf_report_guide.md）：

常见问题排查

问题	解决办法
`npusim: command not found`	未执行`source set_env.sh`，或 whl 未安装到 CANN 的 Python 目录，检查`${install_path}`是否一致
覆盖安装后仍用旧版本	确认 pip 安装目标目录为 CANN 的`python/site-packages`，且加了`--upgrade`
编译 whl 失败	先执行`bash ./clear.sh`清理残留再重新`bash ./build_wheel.sh`