Windows 上使用 VSCode + SDCC 开发 51 单片机完整教程

原创于 2025-12-29 14:46:13 发布 · 429 阅读

CC 4.0 BY-SA版权

文章标签：

适用对象：嵌入式初学者、电子爱好者、想摆脱 Keil 2KB 限制的 51 开发者
系统要求：Windows 10 / 11
目标：搭建一个 免费、开源、高效 的 8051 单片机开发环境，支持代码补全、一键编译、一键烧录

为什么选择这个方案？

对比项	Keil C51	VSCode + SDCC
费用	免费版限 2KB	完全免费开源
跨平台	仅 Windows	Windows / Linux / macOS
轻量	庞大 IDE	轻量编辑器 + 命令行
学习价值	黑盒操作	理解编译、链接、烧录全过程

第一步：安装必备工具

1. 安装 SDCC（8051 编译器）

打开 SDCC 官网下载页
下载最新版 Windows 安装包（如 sdcc-4.3.0-setup.exe）
安装时务必勾选 “Add SDCC to PATH”
验证安装：
```
sdcc --version
packihx --version
```
应显示版本号（如 SDCC 4.3.0）

2. 安装 VSCode

从官网下载并安装
安装 C/C++ 插件：
- 打开 VSCode → 左侧扩展（Extensions）
- 搜索 “C/C++” → 安装 Microsoft 官方插件

3. 安装 Python（用于烧录工具）

从 python.org 下载 Python 3.10+
安装时勾选 “Add Python to PATH”
验证：
```
python --version
pip --version
```

4. 安装 stcgal（STC 芯片烧录工具）

在 PowerShell 中运行：

pip install stcgal

验证：

stcgal --version

如果提示权限错误，改用：
pip install --user stcgal
然后将 %APPDATA%\Python\Python311\Scripts 加入系统环境变量 PATH（根据你的 Python 版本调整）

5. 安装 USB 转串口驱动

CH340 芯片（常见于 STC 下载板）：
- 驱动下载：https://www.wch.cn/downloads/CH341SER_ZIP.html
CP2102 芯片：
- 驱动下载：Silabs 官网

安装后，插入 USB 转串口模块，在 设备管理器 → 端口 中应看到类似 “USB-SERIAL CH340 (COM3)”

第二步：创建项目结构

在任意位置（如 D:\8051-project）创建如下目录：

8051-project/
├── src/
│   └── main.c
├── Makefile
└── .vscode/
    └── c_cpp_properties.json

第三步：编写示例代码（`src/main.c`）

#include <8051.h>

void delay_ms(unsigned int ms) {
    unsigned int i, j;
    for (i = 0; i < ms; i++)
        for (j = 0; j < 114; j++);
}

void main(void) {
    P1 = 0x00;  // 初始化 P1 口
    while (1) {
        P1 = ~P1;      // 翻转 P1（LED 闪烁）
        delay_ms(500);
    }
}

使用 #include <8051.h>（SDCC 标准头文件），无需 reg51.h

第四步：配置 VSCode 智能提示

创建 .vscode/c_cpp_properties.json：

{
    "configurations": [
        {
            "name": "8051 (SDCC)",
            "includePath": [
                "${workspaceFolder}/**",
                "C:/SDCC/share/include/mcs51",
                "C:/SDCC/share/include"
            ],
            "defines": [
                "__SDCC__",
                "__SDCC_mcs51",
                "__sfr=volatile unsigned char",
                "__sbit=volatile unsigned char",
                "__at(x)=",
                "__bit=volatile unsigned char"
            ],
            "compilerPath": "C:/SDCC/bin/sdcc.exe",
            "cStandard": "c99",
            "intelliSenseMode": "windows-msvc-x86"
        }
    ],
    "version": 4
}

注意：

路径使用正斜杠 /（VSCode 支持）
如果 SDCC 安装在其他位置，请修改路径

保存后，VSCode 应能正确识别 P1、__sfr 等 8051 特有语法。

第五步：编写 Makefile（一键编译 + 生成 HEX）

创建 Makefile（专为 Windows 优化）：

TARGET = main
SRC_DIR = src
BUILD_DIR = build
CFLAGS = --model-small --opt-code-speed

.PHONY: all
all: $(BUILD_DIR)/$(TARGET).hex

# 编译 C 源码 → 生成 .ihx
$(BUILD_DIR)/$(TARGET).ihx: $(SRC_DIR)/$(TARGET).c
	@if not exist $(BUILD_DIR) mkdir $(BUILD_DIR)
	@sdcc $(CFLAGS) -o $(BUILD_DIR)/$(TARGET).ihx $<

# 由 .ihx → 生成标准 .hex
$(BUILD_DIR)/$(TARGET).hex: $(BUILD_DIR)/$(TARGET).ihx
	@packihx $< > $@
	@echo 生成 $(BUILD_DIR)/$(TARGET).hex 成功！

# 烧录到 STC 单片机
flash: $(BUILD_DIR)/$(TARGET).ihx
	@stcgal -P stc89 -p COM3 $<

# 清理构建文件
clean:
	@if exist $(BUILD_DIR) rmdir /S /Q $(BUILD_DIR)

.PHONY: clean flash