芯耀
与非AI
84
意法半导体在社区发布说明中介绍了 STM32CubeCLI：面向命令行的 STM32 工具链，核心思路是让工具随代码一起走。首页卡片将其概括为——使用 STM32CubeCLI，只需一条命令，即可从任意终端安装、构建、烧录和调试 STM32 项目，并为项目锁定工具版本。
说明：本稿事实来自 community.st.com 开发者新闻帖（作者 mattias norlander，ST Technical Moderator；首次发布 2026-10-01），不是器件数据手册。
背景：IDE 背后的工具管理，现已可独立使用
若你使用面向 Visual Studio Code 的 STM32CubeIDE，从 2025 年 4 月起就已经在使用 STM32CubeCLI 来安装和更新扩展背后的工具；自 2026 年 3 月起，它同样服务于 STM32CubeMX2。现在它可以单独提供：在 Windows、Linux 与 macOS 上，用一条 `cube` 命令完成安装、构建、烧录与调试，既可用于本机终端，也可用于 CI runner。
组成与能力一览
| 组成 | 发布说明中的要点 |
|---|---|
| `cube` 命令 | 统一调用 STM32Cube 工具，例如 `cube cmake`、`cube programmer`、`cube stlink-gdbserver` |
| Bundle manager | 从 ST 公共在线 registry 安装、更新并钉住工具版本；无需登录；不必四处寻找下载包 |
| Bundles | 工具本体：GCC、CMake、Ninja、STM32CubeProgrammer、ST-LINK GDB server 等 |
| 平台 | Windows、Linux、macOS；终端或 CI |
| 版本锁定 | 工程提交 lock file；按 OS + CPU 架构分条目；覆盖 Win/Linux x86_64 与 macOS Intel / Apple silicon |
| 与其他入口关系 | 面向 VS Code 的 STM32CubeIDE、STM32CubeMX2 与命令行共用同一套底层工具 |
| 相对 STM32CubeCLT | 保留熟悉工具，并增加按项目钉版本、统一 registry 与统一命令 |
选型与导入路径
1. 确认团队是否需要「工具版本随仓库提交」以及 CI 与本机同锁。
2. 按操作系统安装：
- Windows（PowerShell）：`irm https://developer.st.com/bundles/install/install.ps1 | iex`
- macOS 或 Linux：`curl -fsSL https://developer.st.com/bundles/install/install.sh | bash -`
3. 在已钉版本的工程中执行：`cube bundle install --project`，再 `cube cmake --preset Debug` 与 `cube cmake --build --preset Debug`。（发布说明写明：每个面向 VS Code 的 STM32CubeIDE 工程都可钉住工具。）
4. 需要完整概念与命令说明时，查阅官方文档：https://dev.st.com/stm32cube-docs/stm32cubecli/latest/en/index.html
5. 若已在使用 STM32CubeCLT，可按发布说明建议在新项目上并行试用 STM32CubeCLI。
需要另行确认的内容
- 具体支持的 MCU 系列矩阵、烧录/调试命令全集：主帖未列完整表 → 以文档与后续官方说明为准。
- lock 文件在磁盘上的具体路径与是否纳入 `.gitignore`：主帖只描述 lock file 概念；社区回复中有路径讨论，本稿不展开。
- 安装脚本在多 `curl` 路径等环境下的行为：以 developer.st.com 当前脚本与社区勘误为准。
- 本稿不声称可完全替代图形 IDE，也不做未核实的工具链性能对比。
延伸阅读
- 社区发布说明：https://community.st.com/stm32-software-tools-165/introducing-stm32cubecli-your-stm32-toolchain-from-the-command-line-168704
- STM32CubeCLI 文档：https://dev.st.com/stm32cube-docs/stm32cubecli/latest/en/index.html
- 安装（Windows）：https://developer.st.com/bundles/install/install.ps1
- 安装（macOS/Linux）：https://developer.st.com/bundles/install/install.sh
参数以意法半导体官方最新资料为准。
