欢迎关注 youcans@xidian【嵌入式软件AI编程】专栏
【嵌入式软件AI编程】03. STM32 VS Code 开发环境与工具链
【嵌入式软件AI编程】04. AI 编程 的STM32开发流程
【嵌入式软件AI编程】05. 安装STM32CubeMX
【嵌入式软件AI编程】06. 安装STM32CubeProgrammer
【嵌入式软件AI编程】07. 安装VS Code与STM32扩展工具

本专栏结合STM32项目实践，介绍嵌入式软件AI编程的实战路径。本专栏内容来自图书《嵌入式系统AI编程》，即将出版。

---

1.2 开发环境的安装与配置

本节按照STM32 VS Code开发环境的组成，说明需要安装的主要工具、推荐安装顺序和关键配置。由于软件版本和安装界面持续更新，正文略过具体安装步骤，重点说明工具作用、配置要点和注意事项。

1.2.2 安装VS Code与STM32扩展工具

完成STM32基础工具安装后，还需要安装VS Code与STM32扩展工具。VS Code是开发环境的主要操作界面，STM32扩展工具则将STM32工具链集成到VS Code中，使其具备工程管理、编译构建、程序下载和在线调试等能力。

1.2.2.1 安装Visual Studio Code（VS Code）

VS Code是微软推出的轻量级代码编辑器，可以通过插件扩展集成STM32开发工具和AI编程工具，是本书搭建STM32 VS Code开发环境的基础平台。

第1步：获取安装包。

从 VS Code官方网站 https://code.visualstudio.com/ 获取安装程序，根据所用操作系统选择对应版本。本书以64位Windows 10/11系统为例，下载对应版本的安装程序即可。

第2步：运行安装程序。

双击运行VS Code安装程序，按照提示完成安装。安装路径可以保留默认设置，也可以设置为自定义目录。如图1-4所示，在“选择附加任务”页面，建议勾选“添加到PATH”和“通过Code打开”选项，便于从文件夹打开工程或在终端中调用VS Code。

第3步：启动并验证。

安装完成后要重启计算机，再次启动VS Code，确认软件能够正常打开。

第4步：安装中文语言包（可选）。

在VS Code左侧活动栏中单击“扩展（Extensions）”图标，在扩展视图搜索“Chinese”，选择Microsoft发布的中文语言包，单击“安装”按钮安装。安装完成后，重启VS Code即可切换为中文界面。

1.2.2.2 安装STM32扩展工具

STM32CubeIDE for Visual Studio Code是STMicroelectronics官方提供的STM32开发扩展包，为VS Code增加STM32工程管理、代码编辑、编译构建、程序烧录和在线调试等功能。

第1步：创建STM32专用配置文件。

为避免与其他开发环境的冲突，推荐为STM32开发创建一个专用的配置文件（Profile）。依次选择“文件→首选项→配置文件→新建配置文件”，创建名为“STM32”的配置文件，并勾选“将此配置文件用作新窗口的默认设置”。切换到该配置文件。

第2步：搜索并安装扩展包。

打开VS Code，单击左侧活动栏中的“扩展（Extensions）”图标，或按Ctrl+Shift+X打开扩展视图，如图1-5所示。

图1-5 安装STM32扩展工具

在搜索框中输入“STM32CubeIDE”，找到STM32扩展工具，并确认发布者为STMicroelectronics，然后单击“安装”按钮。安装全程需保持有效网络连接，等待STM32开发所需的相关组件和工具包安装完成。

第3步：打开STM32Cube开发界面。

安装完成后，重启VS Code，在左侧活动栏中会出现蝴蝶图案的STM32Cube图标。点击该图标即可打开如图1-6所示的STM32开发界面，包含快捷操作、资源文档和工具包管理器等区域，说明STM32扩展工具已经安装成功。
第4步：工具包初始化。
单击STM32Cube Bundles管理器下的“系统（System）”按钮，打开工具包管理界面。首次打开时，工具包会自动检测所需的基础开发工具，按提示完成安装或更新。相关组件显示为Up to date，表明基础工具已经准备就绪。

图1-6 STM32Cube开发界面

1.2.3 检查STM32 VS Code开发环境

完成VS Code与STM32扩展工具安装后，还需要对开发环境进行配置和检查，确认STM32扩展工具、终端环境和开发板连接均能正常工作，为后续创建STM32工程做好准备。

第1步：检查STM32 VS Code开发界面。

打开VS Code，切换到之前创建的STM32配置文件。单击左侧活动栏中的STM32Cube图标，确认能够正常打开STM32开发界面。如果没有STM32Cube图标，应检查STM32扩展工具是否已经安装并启用。

第2步：检查Bundle Manager工具包状态。

在STM32开发界面中，单击STM32CUBE BUNDLES 管理器区域标题，打开工具包管理界面，查看工具包状态。
如果组件显示为已安装或可用，说明STM32扩展工具的基础环境已准备就绪，可以通过VS Code调用编译、构建、烧录和调试所需的命令行工具。如果仍有组件未安装或需要更新，可在Bundles管理器中选中对应工具包，单击“安装”按钮手动安装。

第3步：检查ST-LINK与开发板连接。

将STM32开发板通过ST-LINK接口连接到计算机。如图1-7所示，单击左侧活动栏中的“运行和调试”图标，在调试窗口中找到STM32CUBE DEVICES AND BOARDS区域。

图1-7 检查ST-LINK与开发板连接

如果开发板连接正常，该区域会显示识别到的ST-LINK调试器，例如STLINK-V3 STMicroelectronics，右侧窗口中也会显示连接信息。如果显示“No device detected”，应先通过Windows设备管理器检查端口，或使用STM32CubeProgrammer验证开发板连接状态。
完成以上检查后，STM32 VS Code开发环境已基本准备就绪。下一节将通过创建第一个STM32工程，进一步验证从代码编写到烧录调试的完整流程。

---

版权声明：

欢迎关注 youcans@xidian【嵌入式软件AI编程】专栏
转发必须注明原文链接：
【嵌入式软件AI编程】07. 安装VS Code与STM32扩展工具
Copyright by ai4mcu@qq.com
Crated：2026-09