1. 为什么选择VSCode来开发雅特力芯片？

如果你之前一直用Keil或者IAR这类传统的IDE来开发单片机，第一次听说用VSCode来搞，心里肯定会犯嘀咕：这玩意儿不是个文本编辑器吗？能行吗？我刚开始也是这么想的，但实际用下来，真香。VSCode现在已经远不止一个编辑器了，它通过强大的插件生态，完全可以变成一个高度定制化、轻量且高效的集成开发环境。

对于雅特力（Atery）这类基于ARM Cortex-M内核的芯片来说，开发的核心无非就是写代码、编译、下载、调试。Keil和IAR把这些功能都打包好了，开箱即用，但代价是软件笨重、收费昂贵（虽然你懂的），而且编辑器的体验嘛，只能说“够用”。VSCode的优势就在于，它把选择权交给了你。你可以自己挑选最好用的代码补全插件、最顺手的代码格式化工具，再搭配上GNU-ARM-GCC这套免费且强大的编译工具链，以及专门为Cortex-M调试而生的Cortex-Debug插件，整个开发环境不仅免费，而且效率、可定制性和颜值都上了一个台阶。

我自己从Keil切换到VSCode的契机，是因为需要同时维护多个不同架构的项目，每次切换软件都很麻烦。而在VSCode里，通过不同的工作区（Workspace）和配置文件（tasks.json, launch.json），我可以快速在STM32、雅特力、甚至是RISC-V项目之间无缝切换，所有工具链的路径配置都独立管理，互不干扰。这种感觉就像从一间精装公寓搬进了毛坯房，一开始需要自己装修挺费事，但装修完发现，每一个家具、每一个开关的位置都完全符合自己的习惯，用起来得心应手。

2. 搭建环境前的准备工作

工欲善其事，必先利其器。在开始动手配置之前，我们需要把几样核心的“食材”准备好。别担心，我会把每一步的下载链接和注意事项都讲清楚，确保你一次搞定。

2.1 主角登场：安装VSCode

这个最简单。直接去VSCode官网下载对应你操作系统（Windows、macOS或Linux）的安装包。我建议选择“User Installer”版本，安装过程一路“下一步”就行。安装完成后打开，你会看到一个非常简洁的界面。先别急，我们暂时不需要动任何设置。

2.2 命令行基石：安装Git

为什么开发单片机需要Git？主要有两个原因。第一，我们需要它的“Git Bash”终端。在Windows上，系统自带的CMD或PowerShell对于运行一些类Unix的命令（比如make）支持不够友好，而Git Bash提供了一个非常好用的MinGW环境，可以无缝运行这些命令。第二，代码版本管理是良好开发习惯的起点，用Git来管理你的嵌入式项目，绝对是个好主意。

去Git官网下载安装包。安装过程中，有几个关键选项需要注意：

  • 选择默认编辑器：这里就选“Use Visual Studio Code as Git's default editor”，完美联动。
  • 调整PATH环境：我推荐选择“Git from the command line and also from 3rd-party software”。这个选项会把Git的可执行文件添加到系统的PATH环境变量里，这样无论在VSCode的终端还是其他地方都能直接调用。
  • 选择终端模拟器：选择“Use MinTTY”，这是Git Bash默认的终端，比Windows自带的控制台好用很多。

安装完成后，你可以在任意文件夹右键，看到“Git Bash Here”的选项，点击就能打开一个命令行窗口。我们后续的很多操作都会在这里进行。

2.3 构建助手：安装MinGW-w64（仅Windows用户）

GNU-ARM-GCC负责把C代码编译成机器码，但一个项目通常有多个源文件，需要按照一定的规则和顺序来编译、链接，这个“规则”就是Makefile。make是一个用来解释和执行Makefile的工具。在Linux或macOS上，系统通常自带make。但在Windows上，我们需要自己安装。

MinGW-w64就是一套在Windows上提供GNU工具链（包括make、gcc等）的环境。我们主要用它里面的make.exe。你可以去SourceForge等网站搜索“MinGW-w64”下载。对于嵌入式开发，选择x86_64-posix-seh这个版本通常兼容性较好。

下载下来的是一个压缩包，比如 x86_64-8.1.0-release-posix-seh-rt_v6-rev0.7z。不要双击安装，而是把它解压到一个你喜欢的、路径里没有中文和空格的目录。比如我就放在 D:\Tools\mingw64。解压后，进入 bin 文件夹，你应该能看到 mingw32-make.exe 这个文件。

为了让系统在任何地方都能识别make命令，我们需要把它加入环境变量。在Windows搜索框输入“环境变量”，选择“编辑系统环境变量” -> “环境变量”。在“系统变量”里找到“Path”，点击“编辑”，然后“新建”，把刚才的 D:\Tools\mingw64\bin 路径添加进去。

为了使用方便，我习惯把 mingw32-make.exe 复制一份，并重命名为 make.exe。这样在命令行里直接输入 make 就可以了，更符合习惯。你可以直接在 bin 目录下操作。

2.4 编译核心：获取GNU-ARM-GCC工具链

这是整个工具链的灵魂。雅特力芯片是ARM架构，我们需要ARM公司官方维护的GCC交叉编译工具链。所谓“交叉”，就是在我们x86的电脑上，编译生成能在ARM芯片上运行的代码。

最可靠的来源是ARM开发者网站，或者国内一些大学/机构的镜像站（速度更快）。搜索“GNU Arm Embedded Toolchain”找到下载页面。选择适合你操作系统的版本。对于Windows，下载那个 gcc-arm-none-eabi-版本号-win32.exe 安装程序，或者 -zip 压缩包都可以。

如果你下载的是安装程序，就运行它，安装到一个简单的路径，比如 D:\Tools\gcc-arm-none-eabi。如果下载的是ZIP包，就像处理MinGW一样，解压到目标目录即可。

同样，我们需要把工具链的 bin 目录（例如 D:\Tools\gcc-arm-none-eabi\bin）添加到系统的Path环境变量中。添加完成后，务必重新启动任何一个已经打开的命令行窗口或VSCode，这样新的环境变量才能生效。然后，打开Git Bash或VSCode的终端，输入 arm-none-eabi-gcc --version，如果能看到一长串版本信息，恭喜你，工具链安装成功了。

3. 配置VSCode：从编辑器到IDE

现在“食材”备齐了，我们要在VSCode这个“厨房”里把它们组装起来，做出一道大餐。

3.1 安装必备插件

VSCode的强大，一半在于插件。点击左侧活动栏的扩展图标（四个小方块），搜索并安装以下插件：

  1. C/C++ (Microsoft)：提供C/C++语言的智能感知（IntelliSense）、代码导航、调试支持。这是核心中的核心。
  2. Cortex-Debug (marus25)：这是调试ARM Cortex-M芯片的“神器”。它提供了图形化的寄存器、内存、外设查看视图，让调试体验直逼甚至超越Keil。
  3. ARM Assembly (dan-c-underwood)：如果你需要查看或编写汇编代码，这个插件可以提供语法高亮。
  4. Error Lens：这个插件我非常推荐。它能把错误和警告信息直接显示在产生问题的代码行末尾，让你不用再总是去查看底部的“问题”面板，效率提升巨大。
  5. Code Runner：可以快速运行单文件代码，虽然嵌入式开发中不常用，但偶尔测试个小算法很方便。

安装完插件后，VSCode的界面可能还没什么变化。别急，我们需要创建项目并配置它们。

3.2 创建你的第一个雅特力项目

首先，找一个地方创建一个项目文件夹，比如 My_Atery_Project。然后用VSCode的“文件”->“打开文件夹”菜单，打开这个文件夹。现在，VSCode的资源管理器里显示的就是你的项目根目录了。

在这个根目录下，我建议创建这样几个子文件夹，这是嵌入式项目的常见结构：

My_Atery_Project/
├── Core/           # 存放核心的MCU外设驱动、启动文件等
├── Drivers/        # 存放传感器、屏幕等外部器件驱动
├── Inc/           # 所有的头文件(.h)
├── Src/           # 所有的源文件(.c)
├── Build/         # 编译输出的中间文件和最终文件（可被.gitignore忽略）
├── Makefile       # 构建规则文件
└── .vscode/       # VSCode专属配置文件夹（通常不提交到Git）

你可以先从雅特力官方提供的标准外设库（SPL）或HAL库中，把芯片相关的启动文件（startup_atery_xx.s）、链接脚本（linker_script.ld）和基础驱动文件复制到 Core 和 Src/Inc 目录下。再写一个简单的 main.c，里面就一个空的主函数和死循环。

3.3 配置智能感知（IntelliSense）

为了让VSCode的C/C++插件能正确理解你的代码，比如找到头文件、识别芯片的特殊寄存器定义，我们需要配置 c_cpp_properties.json。

在VSCode中，按 Ctrl+Shift+P 打开命令面板，输入 “C/C++: Edit Configurations (UI)”，回车。这会打开一个图形化配置界面。

  • 编译器路径：这里要填写你的交叉编译器的路径。点击下拉箭头，如果之前环境变量配好了，这里应该能自动检测到类似 arm-none-eabi-gcc 的选项。如果没有，就手动输入完整路径，比如 D:/Tools/gcc-arm-none-eabi/bin/arm-none-eabi-gcc.exe。
  • IntelliSense 模式：选择 gcc-arm。
  • 包含路径：这是关键。你需要在这里添加你项目中所有头文件所在的目录，以及芯片厂商提供的库文件目录。例如：
    "${workspaceFolder}/Inc",
"${workspaceFolder}/Core",
"D:/Tools/gcc-arm-none-eabi/arm-none-eabi/include",
"D:/Tools/gcc-arm-none-eabi/lib/gcc/arm-none-eabi/版本号/include"
    你可以使用 ${workspaceFolder} 这个变量来代表项目根目录。把这些路径都添加进去，这样插件就能找到所有定义，代码跳转、自动补全就生效了。
  • 定义：你可以在这里预定义一些宏，比如芯片型号 AT32F403A，或者 USE_STDPERIPH_DRIVER 来告诉编译器使用标准外设库。

配置完成后，VSCode会在 .vscode 文件夹下生成一个 c_cpp_properties.json 文件。以后你也可以直接编辑这个JSON文件。

4. 编写Makefile：让编译自动化

Makefile定义了整个项目的编译规则。对于新手来说，写Makefile可能有点吓人，但我们可以从一个简单的模板开始，然后慢慢理解。

在你的项目根目录创建一个名为 Makefile 的文件（没有后缀）。下面是一个极简的、针对雅特力项目的Makefile框架：

# 工具链定义
CC = arm-none-eabi-gcc
OBJCOPY = arm-none-eabi-objcopy
SIZE = arm-none-eabi-size

# 编译选项
MCU = -mcpu=cortex-m4 -mthumb -mfloat-abi=hard -mfpu=fpv4-sp-d16
CFLAGS = $(MCU) -O0 -g3 -Wall -fdata-sections -ffunction-sections
CFLAGS += -I./Inc -I./Core

# 链接选项
LDSCRIPT = ./Core/AT32F403A_Flash.ld
LDFLAGS = $(MCU) -T$(LDSCRIPT) -Wl,--gc-sections -Wl,-Map=$(BUILD_DIR)/output.map

# 目标、源文件、对象文件
TARGET = my_atery_project
SRC_DIR = Src Core
BUILD_DIR = Build

# 自动查找所有.c文件
C_SOURCES = $(foreach dir,$(SRC_DIR),$(wildcard $(dir)/*.c))
# 将.c文件路径转换为.o文件路径，并放到Build目录下
OBJS = $(patsubst %.c,$(BUILD_DIR)/%.o,$(notdir $(C_SOURCES)))

# 默认目标
all: $(BUILD_DIR)/$(TARGET).elf $(BUILD_DIR)/$(TARGET).bin

# 创建构建目录
$(BUILD_DIR):
    mkdir -p $@

# 链接：生成.elf文件
$(BUILD_DIR)/$(TARGET).elf: $(OBJS) | $(BUILD_DIR)
    $(CC) $(OBJS) $(LDFLAGS) -o $@
    $(SIZE) $@

# 编译：将.c编译为.o
$(BUILD_DIR)/%.o: */%.c | $(BUILD_DIR)
    $(CC) -c $< $(CFLAGS) -o $@

# 生成.bin文件（用于烧录）
$(BUILD_DIR)/$(TARGET).bin: $(BUILD_DIR)/$(TARGET).elf
    $(OBJCOPY) -O binary $< $@

# 清理构建文件
clean:
    rm -rf $(BUILD_DIR)

.PHONY: all clean

这个Makefile做了几件事：

  1. 定义了使用的编译器、编译和链接参数。
  2. 自动搜索 Src 和 Core 目录下的所有 .c 文件。
  3. 规定如何把 .c 编译成 .o（对象文件）。
  4. 规定如何把所有的 .o 链接成 .elf（可执行文件）。
  5. 规定如何从 .elf 生成 .bin（二进制烧录文件）。
  6. 提供了一个 clean 命令来清理构建产物。

保存这个文件后，在VSCode里打开集成终端（Ctrl+ ），确保终端是Git Bash或PowerShell。在项目根目录下，直接输入 make命令，你就会看到编译开始运行，最后在Build文件夹下生成.elf和.bin` 文件。如果编译出错，它会明确告诉你哪一行代码有问题。第一次成功编译的感觉，非常棒。

5. 配置调试：让代码“活”起来

编译通过只是第一步，能调试才是开发的完整闭环。这里就需要请出我们安装的 Cortex-Debug 插件了。

5.1 配置调试器（以J-Link为例）

你需要一个硬件调试器，比如J-Link、ST-Link、DAP-Link等。以最常见的J-Link为例，你需要先去SEGGER官网下载并安装J-Link的驱动软件。安装后，确保你的调试器通过USB连接电脑，并且连接到了雅特力开发板。

5.2 创建VSCode调试配置

在VSCode中，切换到调试视图（左侧活动栏的“甲虫”图标），点击“创建一个 launch.json 文件”，选择 “Cortex-Debug”。这会在 .vscode 文件夹下生成一个 launch.json 文件。

我们需要修改这个文件，一个针对J-Link的配置示例如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Cortex Debug (J-Link)",
            "cwd": "${workspaceRoot}",
            "executable": "${workspaceRoot}/Build/my_atery_project.elf",
            "request": "launch",
            "type": "cortex-debug",
            "servertype": "jlink",
            "device": "AT32F403A", // 根据你的芯片型号修改
            "interface": "swd",
            "svdFile": "${workspaceRoot}/Core/AT32F403A.svd", // SVD文件路径，非常重要！
            "runToEntryPoint": "main",
            "armToolchainPath": "D:/Tools/gcc-arm-none-eabi/bin"
        }
    ]
}

这里有几个关键点：

  • executable：指向你Makefile生成的 .elf 文件。
  • servertype：根据你的调试器选择，如 jlink, stlink, pyocd 等。
  • device：填写准确的芯片型号，Cortex-Debug和调试器驱动会根据这个选择正确的调试协议。
  • svdFile：这是点睛之笔！SVD文件是芯片厂商提供的XML格式文件，描述了芯片所有外设寄存器的布局。把它配置进来后，在调试时，Cortex-Debug插件会自动生成一个“外设寄存器”视图，你可以像在Keil中一样，实时查看和修改GPIO、USART、TIMER等所有外设的寄存器值，一目了然。这个文件通常可以从雅特力官方的包或Keil支持包里找到。

5.3 开始调试

配置保存后，在调试视图中，选择“Cortex Debug (J-Link)”配置，然后按F5或点击绿色三角开始调试。VSCode会启动调试会话：

  1. 它会调用J-Link GDB Server连接你的板子。
  2. 加载 .elf 文件到芯片Flash。
  3. 运行到 main 函数开头暂停。

此时，你可以看到熟悉的调试控件（继续、单步、步入、步出），可以设置断点，查看变量，调用堆栈。更重要的是，你可以打开“外设寄存器”视图，直观地监控硬件状态。这种将强大代码编辑器和专业调试能力结合在一起的体验，是传统IDE很难提供的。

6. 避坑指南与效率技巧

搭建过程中难免会遇到问题，这里分享几个我踩过的坑和解决办法。

坑1：编译时报错“找不到头文件” 这几乎都是 c_cpp_properties.json 里的“包含路径”没设对。确保路径填写正确，并且使用了正确的斜杠（在JSON中正反斜杠都可，但建议用/）。可以使用绝对路径，也可以使用 ${workspaceFolder} 变量。

坑2：make 命令找不到 检查MinGW的 bin 目录是否已添加到系统Path，并重启了终端。在VSCode的终端里，输入 where make 命令，看它能否找到 make.exe 的位置。

坑3：调试器连接失败

  • 检查硬件连接：USB线、SWD线是否接好。
  • 检查驱动：设备管理器中调试器是否被正确识别（有无感叹号）。
  • 检查 launch.json：device 名称是否完全正确，大小写敏感。可以尝试在J-Link Commander等工具里手动连接一下，看是否能识别到芯片ID。
  • 检查权限：在Linux/macOS下，可能需要将用户加入 dialout 组以获得串口/USB设备访问权限。

效率技巧1：使用Tasks实现一键编译 除了在终端敲 make，我们可以在VSCode中配置一个任务，绑定到快捷键。在 .vscode 下创建 tasks.json：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Build Project",
            "type": "shell",
            "command": "make",
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": ["$gcc"]
        }
    ]
}

这样，按 Ctrl+Shift+B 就可以直接执行编译，并且错误会集成到VSCode的“问题”面板中。

效率技巧2：使用代码片段（Snippets） 对于嵌入式开发中经常重复的代码结构，比如GPIO初始化、中断服务函数框架，可以创建自定义代码片段。在VSCode中，文件 -> 首选项 -> 用户片段，选择C语言，就可以定义你自己的片段。比如输入 gpio_init 按Tab，就自动展开一段GPIO配置的代码，能极大提升编码速度。

整个环境搭建下来，初期确实比直接打开Keil要费时费力，但这是一次性的投资。一旦配置完成，你得到的是一个高度个性化、流畅且免费的专业开发环境。更重要的是，你在这个过程中真正理解了工具链的各个环节是如何协作的，这种掌控感，是使用黑盒化的商业IDE无法给予的。当你在VSCode里优雅地编写、构建、调试雅特力项目时，你会觉得这一切的折腾都是值得的。

Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

cover

状态丢失排障：Claude 持久记忆的跨会话局限与知芽 Notebook Skill 单元记忆如何沉淀可复用知识资产

avatar DeepSeek技术社区
cover

不加一个参数，能力反超旗舰：大模型的“另一半功夫“

avatar DeepSeek技术社区
cover

基于AI agent的智能图书馆

avatar DeepSeek技术社区