基于vscode在WSL中配置PlatformIO开发环境
一、虚拟机中新建目录
mkdir platformIO
cd platformIO/
二、安装必要的系统包
首先打开WSL终端,执行以下命令安装基础编译环境和Python虚拟环境支持:
sudo apt update
sudo apt install -y python3-pip python3-venv
三、安装PlatformIO Core
直接使用pip安装PlatformIO核心工具。为了提升下载速度,可以使用国内镜像源-7:
pip3 install -U platformio -i https://pypi.tuna.tsinghua.edu.cn/simple
安装成功后,尝试在终端输入 pio --version
,如果能正常显示版本号,说明安装成功。
pio --version
四、将项目文件复制到 WSL
# 假设你的项目在 Windows 的 E:\PlatformIO_Projects\my_project
# 在 WSL 中复制项目文件(从 Windows 分区复制到 WSL 家目录)
cp -r /mnt/d/Download/firmware-master2 ~/platformIO/# 进入项目目录
cd ~/platformIO/firmware-master2/# 查看项目文件
ls -la# 应该看到类似结构:
# platformio.ini
# src/
# include/
# lib/
五、 编译和测试
# 在项目目录中执行编译
pio run# 或者使用并行编译加快速度
pio run -j 4
【加速方案:国内镜像源】
#立即加速的解决方案:使用国内镜像源(推荐)# 创建 PlatformIO 配置文件
mkdir -p ~/.platformio# 配置国内镜像源
cat > ~/.platformio/platformio.ini << 'EOF'
[platformio]
default_envs = powerbank-s3-epaper
packages_dir = ~/.platformio/packages
platforms_dir = ~/.platformio/platforms
framework_dir = ~/.platformio/frameworks# 使用国内镜像
pypi_url = https://pypi.tuna.tsinghua.edu.cn/simple
package_blob_url = https://dl.registry.platformio.org/packages[env:powerbank-s3-epaper]
platform = espressif32
board = t-deck
framework = arduino
EOFpio run -j 4
六、编译和烧录
# 编译并上传到设备
pio run -t upload# 或者分开执行
pio run # 只编译
pio run -t upload # 只上传
七、测试完整流程
# 1. 进入项目目录
cd ~/platformIO/your_project_name# 2. 清理之前的编译(可选)
pio run -t clean# 3. 编译项目
pio run# 4. 上传到设备
pio run -t upload# 5. 监视串口输出(如果需要)
pio device monitor
八、解决可能的依赖问题
# 安装常用的编译工具
sudo apt update
sudo apt install -y git build-essential# 如果使用 ESP32,可能需要安装 esptool
pip3 install esptool