2026 年了，入坑 ESP32 的人反而越来越多。小红书上"0基础手搓游戏机""ESP32 烧录教程"这类帖子动辄几千收藏，B站一个"大过年的尽然还有人愿意学ESP32"的入门教程播放量五万多。但很多人没倒在 C 语言上，先倒在了第一步：PlatformIO 装不上、下载慢、建项目一直转圈。
这不是个例。7 月有位微博用户吐槽：整 PlatformIO 的库下了一晚上，早上醒来继续报错，“力竭了，不优化这玩意我不用了”。B站上隔三差五就有人发视频问"platformio 为什么下这么慢"。哔哩哔哩8 月 8 日一条《新建工程缓慢解决方法》底下，还有人在评论里求助：“创建工程一直在转圈圈，我整了好久了”。哔哩哔哩知乎上更早有人实测：不做任何优化，从装插件到把 ESP32 环境跑通，“总体耗时大概 8 小时”。知乎8 小时是 2023 年一位博主的单机实测，不同网络差别会很大，但方向不会错：PlatformIO 冷启动要下载的东西又多又散，对国内网络极不友好。
这种慢不只是劝退新人。就连用惯了的开发者也承认，“就是因为网络问题更新加载有点慢”。知乎
先搞明白：它到底在下什么
很多人以为"换源"是一招制敌，其实 PlatformIO 的下载分三段，每段卡的地方不一样：
第一段：装 VSCode 插件时，插件会自动下载 PlatformIO Core 运行环境和一堆 Python 依赖。这一步走的是 Python 的 pip 渠道。
第二段：第一次给某块板子建项目时（比如你选了 ESP32），它要下载这块板子对应的开发平台和编译工具链——这才是体积最大的一段。有教程作者专门提醒：就算第一步下载成功了，“创建 ESP32 项目时仍然需要下载更多资源”。知乎
第三段：装第三方库（传感器驱动、显示屏库之类），又是一轮下载。
三段各有各的下载渠道。这就是为什么你只把 pip 换成国内源，建项目时照样卡死——药没下对症。
8 月实测：哪些方法还真能用
我这几天把社区里流传的主要方法挨个验证了一遍，结论如下。
先说一个要避坑的：网上流传最广的"清华镜像"，失效了。
很多 2024、2025 年的教程，包括一些写得相当认真的知乎文章，都教你在 VSCode 里把 PlatformIO 的镜像地址填成清华源 `https://mirrors.tuna.tsinghua.edu.cn/platformio/`。{{{CUSTOM_HTML_TAG_5}}}我 8 月 24 日实测：清华镜像站主页正常，但这个 platformio 路径已经 404，换了几个相关路径也一样。照着老教程填这个地址，等于白忙。也有用户自己摸索换源，在设置里填过阿里的 Python 源，但配置入口一多就容易填错地方。知乎
还能用的方法，按卡住的阶段分：
卡在装插件、装 Core 阶段 → 换 pip 源。 安装好的 Python 默认走国外源，下载第三方库非常慢，极端情况下甚至无法安装，所以要先把 pip 源换成国内源。知乎我实测阿里云、清华的 PyPI 镜像目前都正常。操作很简单：命令行里一句 `pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/`，再装 PlatformIO 相关的 Python 依赖就快多了。
卡在建项目、下工具链阶段 → 这是重灾区，给你三条路：
一是代理。如果你有，这是最省事的，整个下载链路都能覆盖。上面那条"转圈圈"的评论，视频作者的解法就是走代理。
二是离线资源包。思路是让别人下好、打包给你，直接解压到 `.platformio` 目录（保留 penv 和 python3 两个文件夹，其余替换掉）。2023 年那篇"五分钟离线配置"就是这个思路。注意一个坑：离线包有时效，太老的包版本对不上现在的平台，找包时优先找近一两年更新的。
三是重试。PlatformIO 的下载有缓存机制，断点续传是事实存在的，下载失败不要从头再来，重试几次往往能蹭完全程。网速慢但能通的情况下，睡前挂着下载也是一条笨办法——那位"下了一晚上"的朋友，问题可能出在库本身报错，不一定是白等。
卡在装库阶段 → 先看报错内容。 如果报错是"找不到库"或者代码报错，那不是网络问题，换源没用；确认是下载超时再按上面的代理/重试管。
顺手说两件值得知道的事
一是 PlatformIO 的文档开始做本地化了。7 月 27 日，官方文档翻译项目 platformio-docs-l10n 发布，在 Crowdin 上征集翻译，GitHub 和国内的 AtomGit 上都有仓库。知乎进度还早，但英文文档劝退这个问题，至少在解决的路上了。
二是现在越来越多人用 AI 配合 PlatformIO 干活。B站上已经有人录"VSCode + Claude Code + PlatformIO 零手写代码开发 STM32"的实况，全程用 AI 写代码，45 分钟的开发过程剪成了 2 分钟。哔哩哔哩对新手来说这其实是利好：环境配置这种最磨人的环节，问 AI 比自己翻旧教程效率高——但前提是你得知道哪些旧教程已经过时，比如那个 404 的清华镜像。
最后给个行动清单
准备入坑：先换 pip 源，再装插件，能省掉第一段的大部分等待
建项目转圈：有代理开代理，没有就找近一年的离线包，或者睡前挂着重试
照着旧教程换源没效果：先验证地址还活着（浏览器直接打开试试），别在一棵树上耗
装库报错：分清是"找不到库"还是"下载超时"，两种病两种药
嵌入式入坑的第一道坎从来不是技术，是环境。把网络这关过了，后面几块钱的 ESP32 能玩出的花样，比你想的多。
