使用 WSL2 + Ubuntu-22.04(D盘/其他盘、发行版本可改) + VSCode 搭建 ESP32/ESP32-S3 开发环境
参考文案及视频链接WSL2安装Ubuntu完整教程自定义安装目录到D盘--location一键搞定【图文】使用 WSL VSCode 搭建 ESP32/ESP32-S2 开发环境WSL不同版本的Ubuntu更换清华镜像加速Ubuntu软件下载速度【2024最新版 ESP32教程基于ESP-IDF】ESP32入门级开发课程 更新中 中文字幕【乐鑫教程】| 在 Windows 系统上运行 Linux 开发 ESP32使用 WSLVScode 搭建 ESP-IDF 环境教程一、前置条件操作系统Windows 10版本 2004 及以上或 Windows 11权限需要管理员权限运行 PowerShellBIOS开启虚拟化二、安装WSL1.打开控制面板然后点击程序2.点启动或关闭Windows功能勾选这三个3.勾选完点击确定后等待进度条完成后重启电脑4.检查 WSL 状态打开PowerShell管理员运行以下命令检查 WSL 是否已安装wsl --status如果提示未安装适用于 Linux 的 Windows 子系统说明安装失败可能系统硬件不支持看前置条件是否达成。三、安装Ubuntu-22.04(D盘/其他盘)1.使用一键安装命令在PowerShell管理员使用下面的代码一键安装Ubuntu-22.04(D盘)代码里的 Ubuntu-22.04 可以改其他的发行版本最后面的 D:\wsl\ubuntu-22.04 可以改为你想要的路径该命令会自动完成下载并安装 Ubuntu-22.04将虚拟磁盘文件ext4.vhdx存储到D:\wsl\ubuntu-22.04目录首次安装完成后会提示设置用户名和密码wsl --install -d Ubuntu-22.04 --location D:\wsl\ubuntu-22.042.安装验证wsl -l -v出现上面红色框的信息说明安装成功3.启动 Ubuntu-22.04wsl.exe -d Ubuntu-22.04注首次启动会让你设置用户名和密码用户名一开始默认是自己电脑的用户名可以不设置四、在 Ubuntu-22.04 搭建 ESP-IDF 环境1.在 Ubuntu-22.04 里先把路径改到你的用户文件夹注在home文件夹下拉取仓库可获得更好的编译性能在其他路径比如/mnt挂载的硬盘会导致编译性能会下降cd /home/{你创建的用户名}2. 克隆 esp-gitee-tools 代码仓库git clone https://gitee.com/EspressifSystems/esp-gitee-tools.git3.克隆 ESP-IDF 代码仓库因为ESP-IDF 代码仓库是在github拉取可能拉取失败先运行esp-gitee-tools文件夹里的jihu-mirror.sh加速ESP-IDF 代码仓库拉取还有一种方法在gitee拉取但有可能在拉取过程中出现让你在命令窗口里登录gitee我尝试了好几次都失败了cd ./esp-gitee-tools 或者 cd /home/{你创建的用户名}/esp-gitee-tools ./jihu-mirror.sh set然后退出esp-gitee-tools文件夹拉取ESP-IDF 代码仓库cd .. git clone --recursive https://github.com/espressif/esp-idf.git4.切换ESP-IDF版本在esp-idf 文件夹下切换版本注大版本之间不兼容比如在 v4 编译的项目在 v5 编译不了这里是用v5.5.4(也就是v5)版本可以换版本cd ./esp-idf 或者 cd /home/{你的用户名}/esp-idf git checkout v5.5.4切换版本后还需要更新一下模块git submodule update --init --recursive5.安装 ESP-IDF 工具链(1)将默认 python 切换为 python3修改 ubuntu 源到国内镜像cd /etc/apt/ sudo cp sources.list sources.list.bak sudo vim sources.list在sources.list里面编辑键盘输入ggdG清除所有镜像文档后按键盘i进入编辑模式鼠标右键粘贴下面的清华源换其他源可以# 默认注释了源码镜像以提高 apt update 速度如有需要可自行取消注释 deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse deb http://security.ubuntu.com/ubuntu/ jammy-security main restricted universe multiverse # deb-src http://security.ubuntu.com/ubuntu/ jammy-security main restricted universe multiverse # 预发布软件源不建议启用 # deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse # # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse然后按ESC退出编辑模式之后输入:wq 注意冒号也输入保存文件并退出sources.list接下来更新软件源并安装 python3sudo apt-get update sudo apt-get install python3 python3-pip python3-setuptools将 python 默认切换为 python3sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 10(2)将 pip 源更换到国内镜像可选步骤推荐pip 版本 10.0.0可以使用以下方式pip --version pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple pip config set global.trusted-host mirrors.tuna.tsinghua.edu.cn6.安装依赖在终端输入以下指令安装依赖工具sudo apt-get install git wget flex bison gperf python3 python3-pip python3-setuptools python3.10-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util7.安装编译工具链在esp-idf 文件夹下运行安装cd /home/{你的用户名}/esp-idf ../esp-gitee-tools/install.sh出现下面图片里的信息即 ESP-IDF 环境部署成功五、安装 VSCode WSL 插件还在编辑中。。。可看https://blog.csdn.net/qq_20515461/article/details/108818485的第5个