【Ubuntu】Ubuntu+VScode+ESP-IDF 的环境搭建
<h1 id="引言">引言</h1><p>由于在 Linux 系统上配置 esp 环境较为繁琐，故在此做个记录。</p>
<h1 id="视频教程">视频教程</h1>
<blockquote>
<p>ubuntu下的ESP-IDF开发环境的搭建</p>
</blockquote>
<h1 id="ubuntu-中配置流程">Ubuntu 中配置流程</h1>
<h2 id="一安装网络工具">一、安装网络工具</h2>
<pre><code>sudo apt-get install net-tools
</code></pre>
<h2 id="二查看-ip-地址">二、查看 ip 地址</h2>
<pre><code>ifconfig
</code></pre>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217090229900-1210278376.png" alt="image" loading="lazy"></p>
<h2 id="三使用-mobaxterm-新建-ssh-协议终端">三、使用 MoBaXterm 新建 SSH 协议终端</h2>
<p><strong>输入刚刚查看的 ip 地址和 Ubuntu 终端的用户名。</strong></p>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217090506372-2031701282.png" alt="image" loading="lazy"></p>
<p><strong>输入密码后，即可将 MoBaXterm 成功登录上 Ubuntu 系统。</strong></p>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217090710737-539238297.png" alt="image" loading="lazy"></p>
<h2 id="四安装必要工具">四、安装必要工具</h2>
<h3 id="1配套必要的工具">1、配套必要的工具</h3>
<p>其中有很多个工具：</p>
<pre><code>sudo apt-get install git wget flex bison gperf python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0 net-tools
</code></pre>
<h3 id="2拉取-esp-idf-开发-sdk">2、拉取 ESP-IDF 开发 SDK</h3>
<ol>
<li>
<p>新建一个目录</p>
<pre><code> mkdir esp
</code></pre>
</li>
<li>
<p>进入其目录，并拉取 esp 工具</p>
<pre><code> cd esp
git clone https://gitee.com/Espressifsystems/esp-gitee-tools.git
</code></pre>
</li>
<li>
<p>进入 esp 工具目录，并执行 jihulab 脚本，会将 jihulab 的地址自动替换为 jihulab 上的镜像地址</p>
<pre><code> cd esp-gitee-tools
./jihu-mirror.sh
./jihu-mirror.sh set
</code></pre>
</li>
</ol>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217093038776-1720268670.png" alt="image" loading="lazy"></p>
<p><strong>接下来即可直接拉取 ESP-IDF 不存在访问问题。</strong></p>
<ol start="4">
<li>
<p>根据 ESP-IDF 编程指南，需要确保有以下软件包（虽然上面可能安装过了）</p>
<pre><code> sudo apt-get install git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0
</code></pre>
</li>
<li>
<p>安装 python3<br>
<strong>执行以下指令查询当前 python 版本：</strong></p>
<pre><code> python3 --version
</code></pre>
</li>
</ol>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217094003535-1218181669.png" alt="image" loading="lazy"></p>
<ol start="6">
<li>
<p>回到上一级目录，并获取 ESP-IDF</p>
<pre><code> cd ..
git clone -b v5.5.1 --recursive https://github.com/espressif/esp-idf.git
</code></pre>
</li>
<li>
<p>进入 esp-idf 目录，进行切换版本（选择最新的或者你想要的），并更新相应子模块</p>
<pre><code> cd esp-idf
git checkout v5.5.1
git submodule update --init --recursive
</code></pre>
</li>
<li>
<p>此目录下安装编译工具<br>
<strong>执行 esp-gitee-tools 目录下的 install.sh 脚本：</strong></p>
<pre><code> ../esp-gitee-tools/install.sh
</code></pre>
</li>
</ol>
<h2 id="五拉取例程">五、拉取例程</h2>
<p><strong>回到 esp32 目录，并拉取例程：</strong></p>
<pre><code>cd ..
git clone --recursive https://gitee.com/vi-iot/esp32-board.git
</code></pre>
<h2 id="六配置-esp-idf-环境变量每次都要">六、配置 ESP-IDF 环境变量（每次都要）</h2>
<p><strong>进入 esp-idf 目录，执行以下脚本，会将 ESP-IDF 环境变量设置到我们当前的环境变量中：</strong></p>
<pre><code>cd esp-idf
source export.sh
</code></pre>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217105509703-113889284.png" alt="image" loading="lazy"></p>
<h2 id="七编译烧录">七、编译、烧录</h2>
<pre><code>cd ../esp32-board/helloworld
idf.py build
idf.py flash
</code></pre>
<h2 id="八一些方便的配置">八、一些方便的配置</h2>
<h3 id="登录后自动配置-esp-idf-环境变量">登录后自动配置 ESP-IDF 环境变量</h3>
<p>在 <strong>.profile</strong> 文件中最后一行加入：<code>source esp/esp-idf/export.sh</code>，登录后即可自动配置 ESP-IDF 环境变量。</p>
<h3 id="将用户添加进串口设备专用组">将用户添加进串口设备专用组</h3>
<p>输入 <code>sudo usermod -aG dialout 用户名</code>，即可不需要每次连接上设备的时候都需要给设备文件权限。</p>
<h1 id="vscode-中配置流程">VScode 中配置流程</h1>
<h2 id="一本地插件安装">一、本地插件安装</h2>
<p>基本配置流程例如中文什么的就不说了，下面直接安装下面三个插件：</p>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217105943037-1605026682.png" alt="image" loading="lazy"></p>
<h2 id="二ssh-配置">二、SSH 配置</h2>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217110118376-1390637647.png" alt="image" loading="lazy"></p>
<h2 id="三连接-ubuntu-终端">三、连接 Ubuntu 终端</h2>
<p><strong>右键选择某个窗口中连接，选择 Linux 系统，并输入密码即可连接成功：</strong></p>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217110347113-575019156.png" alt="image" loading="lazy"></p>
<p><strong>重启后，打开文件夹例如例程中的 helloworld 然后进行连接，输入密码进行连接工程：</strong></p>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217111721807-1962256040.png" alt="image" loading="lazy"></p>
<h2 id="四网络插件安装">四、网络插件安装</h2>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217110906224-43823146.png" alt="image" loading="lazy"></p>
<h2 id="五esp-idf-插件配置">五、ESP-IDF 插件配置</h2>
<p><strong>点击<code>Configure extension</code>：</strong></p>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217111546584-100106434.png" alt="image" loading="lazy"></p>
<p><strong>后面检查好三个路径是否有问题，然后再点击下一步进行安装某些工具即可完成配置。配置完成界面如下：</strong></p>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217112027177-73773249.png" alt="image" loading="lazy"></p>
<h2 id="六添加例程源码路径到工程中">六、添加例程源码路径到工程中</h2>
<p><strong>（注意，前面 ESP-IDF 没配置好，这里就会出问题）</strong><br>
<strong>原本路径报错：</strong></p>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217111033789-624462462.png" alt="image" loading="lazy"></p>
<p><strong>Ctrl + Shift + P，选择<code>ESP-IDF: Add VS Code Configuration Folder</code>后路径恢复正常：</strong></p>
<p><img src="https://img2024.cnblogs.com/blog/3619091/202512/3619091-20251217111455072-1019433563.png" alt="image" loading="lazy"></p>
<p><strong>完成！</strong></p>
<h1 id="博客导航">博客导航</h1>
<blockquote>
<p>博客导航</p>
</blockquote>
</div>
<div id="MySignature" role="contentinfo">
<p>本文来自博客园，作者：膝盖中箭卫兵，转载请注明原文链接：https://www.cnblogs.com/Skyrim-sssuuu/p/19360191</p><br><br>
来源：https://www.cnblogs.com/Skyrim-sssuuu/p/19360191
頁:
[1]