第4章 · CANN基础软件包安装
CANN Toolkit 获取、安装流程详解、环境变量配置（set_env.sh）、安装后验证。
4.1 获取 CANN Toolkit
说实话，安装 CANN 的第一步就是拿到正确的安装包。我个人习惯直接从 昇腾社区 下载，或者用华为云镜像站。你想想看，如果驱动和固件版本是 7.0.0，那 Toolkit 最好也用同一个大版本，不然容易出幺蛾子。
下载时你会看到两种格式：.run 和 .tar。我建议新手用 .run，因为它自带安装向导，省事。老手嘛，随意。
4.2 安装流程详解
拿到安装包后，别急着双击。先给执行权限：
chmod +x Ascend-cann-toolkit_7.0.0_linux-x86_64.run然后运行安装。我个人习惯用 --install 指定路径，方便管理：
./Ascend-cann-toolkit_7.0.0_linux-x86_64.run --install --install-path=/home/ascend/toolkit如果不指定路径，默认装到 /usr/local/Ascend 下。嗯，这里要注意：安装路径不要有中文或空格，否则后面 source 环境变量时会哭。
4.3 环境变量配置（set_env.sh）
安装完 Toolkit，最重要的一步就是配置环境变量。CANN 提供了一个现成的脚本 set_env.sh，就在安装目录下。你只需要：
source /home/ascend/toolkit/ascend-toolkit/set_env.sh但说实话，每次手动 source 太烦了。我一般把它加到 ~/.bashrc 里：
echo "source /home/ascend/toolkit/ascend-toolkit/set_env.sh" >> ~/.bashrc
source ~/.bashrc这样每次打开终端就自动加载了。不过要注意，如果你同时装了多个版本的 CANN，环境变量可能会冲突。我个人的做法是：用 export ASCEND_TOOLKIT_HOME 单独指定，然后在 set_env.sh 里只保留当前版本。
| 变量名 | 说明 | 典型值 |
|---|---|---|
| ASCEND_TOOLKIT_HOME | Toolkit 根目录 | /home/ascend/toolkit/ascend-toolkit |
| LD_LIBRARY_PATH | 动态库路径 | $ASCEND_TOOLKIT_HOME/lib64 |
| PATH | 可执行文件路径 | $ASCEND_TOOLKIT_HOME/bin |
| ASCEND_OPP_PATH | 算子包路径 | $ASCEND_TOOLKIT_HOME/opp |
4.4 安装后验证
环境变量配好了，怎么知道装没装对？我最常用的三板斧：
- 查看版本号：
npu-smi info或ascend-dmi -i。如果能显示芯片信息，说明驱动和 Toolkit 基本正常。 - 检查环境变量：
echo $ASCEND_TOOLKIT_HOME，看路径是不是你安装的那个。 - 跑一个简单的算子：比如
atc --version，如果输出 ATC 版本号，那就稳了。
我记得有一次帮同事排查，他执行 npu-smi 报错说找不到命令。结果发现是 PATH 里没加 $ASCEND_TOOLKIT_HOME/bin。说白了，环境变量没 source 对。
source set_env.sh && npu-smi info && atc --version如果三行都正常输出，恭喜你，CANN 基础软件包安装完成！
嗯，到这里 CANN Toolkit 的安装就告一段落了。下一章我们会聊开发环境与运行环境分离部署，不过那是后话。先把眼前的环境跑通，后面才顺手。