前言

做 ESP32 系列开发，PlatformIO 对比原生 Arduino IDE 优势巨大：智能代码补全、规范化工程管理、一键烧录与串口调试、同时兼容 Arduino/ESP-IDF 等多开发框架。但国内开发者使用时几乎都会遇到同一个痛点：安装插件、新建工程阶段下载速度极慢，还频繁出现连接超时、依赖拉取失败，根源在于 PlatformIO 默认从海外服务器获取工具链、固件包资源。

本文全程截图分步教学，手把手带你完成三件核心操作：VSCode 安装 PlatformIO 插件、配置清华镜像加速、创建 ESP32-C3-DevKitM-1 工程。全程可视化操作，零基础也能跟着走完，镜像配置完成后下载速度直接提升十几倍，彻底告别卡在 Resolving dependencies 加载界面的难题。

前置环境

• 操作系统：Windows 10 / Windows 11
• 软件：Visual Studio Code
• 目标开发板：Espressif ESP32-C3-DevKitM-1
• 开发框架：Arduino

一、VSCode 安装 PlatformIO IDE 插件

1. 打开 VS Code，点击左侧侧边栏方块样式的 扩展图标（快捷键 Ctrl+Shift+X），进入扩展市场；
2. 在顶部搜索框输入 PlatformIO IDE，找到橙色蚂蚁图标的官方插件；
3. 点击蓝色「安装」按钮，等待插件下载完成后，按照弹窗提示重启 VS Code；
4. 重启后侧边栏会出现 PlatformIO 专属蚂蚁图标，代表插件安装成功。

二、配置清华镜像

1. 使用快捷键 Ctrl + , 快速调出 VS Code 设置面板；
2. 在设置顶部搜索框输入关键词：platformio core custom_packages index_url；
3. 找到对应配置项，点击在 settings.json 中编辑，打开全局 JSON 配置文件。

清空文件内原有全部内容，直接复制粘贴下方完整清华镜像配置：

{
    "editor.unicodeHighlight.nonBasicASCII": false,
    "security.workspace.trust.untrustedFiles": "open",
    "platformio-ide.customPyPiIndexUrl": "https://pypi.tuna.tsinghua.edu.cn/simple/",
    "platformio-ide.customPATH": "",
    "platformio-core.custom_packages": {
        "index_url": "https://mirrors.tuna.tsinghua.edu.cn/platformio/packages/index.json"
    },
    "platformio.package.registry_url": "https://mirrors.tuna.tsinghua.edu.cn/platformio",
    "platformio.core.http_timeout": 180
}

替换完成后按下快捷键 Ctrl + S 保存 settings.json 文件；
完全关闭所有 VS Code 窗口，重新启动软件，镜像配置才能全局生效。

三、新建 ESP32-C3-DevKitM-1 工程

1. 点击左侧蚂蚁图标，打开 PIO Home（PlatformIO 主页）；
2. 在右侧 Quick Access 区域点击 Open 进入项目操作页；
3. 点击 New Project，弹出工程创建向导窗口。

Espressif ESP32-C3-DevKitM-1

向导参数按需填写：

1. Name：自定义项目名称（仅支持英文，禁止中文、空格、特殊符号）；
2. Board：下拉搜索并选中 Espressif ESP32-C3-DevKitM-1；
3. Framework：选择 Arduino；
4. Location：勾选 Use default location，使用软件默认工程存储路径；
5. 全部填好后点击右下角 Finish。

这样我们的项目配置好了，这里 main.cpp 就是我们程序代码编写的文件。

四、常见问题避坑指南

但是我们发现这样的环境看似可以烧录到 ESP32-C3 的板子中，但是板子没有反应。

为此我们将 platformio.ini 文件进行替换：

[env:esp32c3]
platform = espressif32
board = esp32-c3-devkitm-1          
framework = arduino

monitor_speed = 115200
upload_port = COM3
monitor_port = COM3

board_build.f_cpu = 160000000L
board_build.f_flash = 80000000L
board_build.flash_mode = dio

五、结尾总结

这套基于清华 TUNA 镜像的 PlatformIO 配置方案，专门适配国内网络环境开发 ESP32-C3，全程无复杂命令行操作，纯可视化界面操作，新手也能一次配置成功