ASC-STL环境搭建指南:CANN 9.2.0、毕昇编译器与昇腾950的5项必备组件完整清单
ASC-STL环境搭建指南:CANN 9.2.0、毕昇编译器与昇腾950的5项必备组件完整清单
ASC-STL 是武汉理工大学熊盛武课题组与华为 CANN 团队联合开发的面向昇腾 NPU 的 C/C++ 标准库(纯头文件实现)。搭建 ASC-STL 环境只需准备 CANN 9.2.0、毕昇编译器(基于 Clang 15.0.5)、g++(C++17)、CMake ≥ 3.20 与昇腾 950PR/950DT 处理器共 5 项组件。本文给出一份可直接照做的完整环境搭建清单与验证步骤。
从架构可以看出,ASC-STL 的设备侧编程能力基于 CANN Ascend C,代码由毕昇编译器编译,运行于昇腾 950 系列处理器;运行时依赖 CANN Runtime(AscendCL Runtime API)与 NPU 驱动。这也正是环境搭建需要逐项确认的原因。
📋 5项必备组件清单:ASC-STL 环境要求一览
| # | 组件 | 版本 / 说明 | 备注 |
|---|---|---|---|
| 1 | CANN | 9.2.0 及以上 | 编译需 Toolkit,执行另需匹配的驱动和 Runtime |
| 2 | 毕昇 CCE / clang | 15.0.5 | 随 CANN 提供,无需单独安装 |
| 3 | g++ | 支持 C++17 | 完整 Host 门禁测试同时需 C++20 支持 |
| 4 | CMake | ≥ 3.20 | 用于集成纯头文件库与运行测试 |
| 5 | 处理器 | 昇腾 950PR / 950DT 系列 | CPU 架构需为 aarch64 或 x86_64,操作系统为受支持的 Linux |
💡 一个关键点:ASC-STL 是纯头文件库,不产出任何动态库或静态库。Host 侧只需把
include/目录加入包含路径即可使用;只有调用依赖 AscendCL 的 Runtime 接口时,才需要额外链接ascendcl。
📥 第一步:获取 asc-stl 代码
克隆仓库即可获得全部头文件、示例工程与验证脚本:
git clone https://gitcode.com/cann/asc-stl.git
cd asc-stl
公共头文件集中在 include/asc/ 目录下:include/asc/std/ 下以 <asc/std/...> 提供 C++ 标准库接口,其余以 <asc/...> 提供昇腾扩展与 Runtime 接口。
🚀 第二步:激活 CANN 9.2.0 与毕昇编译器环境
Kernel 侧编译与真机运行前,必须先激活 CANN 环境脚本:
source /usr/local/Ascend/ascend-toolkit/set_env.sh # 换成你的实际安装路径
激活后,毕昇 CCE / clang(15.0.5)与 AscendCL 环境变量即进入当前 shell。仓库提供的 scripts/cann-env.sh 会自动检测 ASCEND_HOME_PATH 与 bisheng 命令是否可用,若检测失败会提示"BiSheng compiler is unavailable",此时先确认 set_env.sh 是否执行成功、Toolkit 是否完整安装。
✅ 第三步:Host 侧快速验证(无需 NPU)
Host 侧使用只需 g++ 与头文件路径,一个最小示例即可验证环境是否就绪:
// sample.cpp —— 仅依赖头文件,无需链接库
#include <asc/std/optional>
#include <asc/std/type_traits>
int main() {
asc::std::optional<int> value = 42;
return *value == 42 ? 0 : 1;
}
g++ -std=c++17 -Wall -Wextra -I asc-stl/include sample.cpp -o sample && ./sample
若能编译运行成功,说明 g++ 的 C++17 支持与 ASC-STL 头文件路径均配置正确。
⚡ 第四步:编译并运行昇腾 950 快速入门工程
examples/quick_start/ 提供了完整的 Host + Kernel 入门工程(融合算子 z = ReLU(x + y))。从克隆后的仓库根目录执行:
source /usr/local/Ascend/ascend-toolkit/set_env.sh
cmake -S examples/quick_start -B build/quick-start-17 \
-DASC_STL_EXAMPLE_STANDARD=17 -DSOC_VERSION=Ascend950PR_9599 \
-DCMAKE_BUILD_TYPE=Release
cmake --build build/quick-start-17 -j2
timeout --signal=TERM --kill-after=10s 60s build/quick-start-17/asc_stl_quick_start
注意 SOC_VERSION 必须匹配你实际受支持的 950 设备型号。运行成功会返回 0 并输出 ASC_STL_QUICK_START_PASS;没有 NPU 时可以完成构建,但设备运行需要真实可用的昇腾 950 卡。
🧪 第五步:运行本地验证与自检脚本
clone 后即可用仓库自带的验证入口做环境体检:
| 验证场景 | 命令 | 是否需要 CANN / NPU |
|---|---|---|
| Host 门禁 | bash scripts/ci-quick-check.sh |
否(需 Python 3) |
| CMake + CTest | cmake -B build -DBUILD_TESTING=ON && cmake --build build -j && cd build && ctest |
否 |
| 设备编译门 | bash build.sh --device-compile -p <CANN 路径> |
需要 CANN |
| 真机回归 | bash scripts/ci-hardware-check.sh |
需要昇腾设备 |
构建与测试的详细说明见 docs/zh/guide/building_and_testing.md,完整的 Host / Kernel 使用方式与本地验证流程见 docs/zh/quick_start.md。
🛠️ 常见环境问题速查
| 现象 | 排查建议 |
|---|---|
找不到 bisheng 命令 |
未激活 CANN 环境,重新执行 set_env.sh 并确认 Toolkit 安装完整 |
SOC_VERSION 不匹配 |
检查实际 950 设备型号,修正 -DSOC_VERSION 参数 |
| C++20 头文件编译失败 | g++ 版本过旧或系统 glibc 低于 2.36;Ubuntu 24.04 的 GCC 13 可满足完整 Host 门禁 |
| 编译成功但设备无法运行 | 驱动与 Runtime 版本未匹配 CANN 9.2.0,或 /dev/davinciN 设备不可用 |
📚 延伸文档
- 标准层完整 API 列表:docs/zh/api/standard/standard.md
- C++ 语言模式与兼容性说明:docs/zh/guide/cpp_compatibility.md
- 各接口的调用位置与约束:docs/zh/api/README.md
- 更多可运行示例(GM/UB 流水拷贝、并行算法):docs/zh/examples/
按以上 5 步完成环境搭建与验证后,你已获得一个可编译 Kernel、可运行示例、可通过门禁检查的 ASC-STL 开发环境。

