ROS2进阶 -- 硬件篇第五章 -- Ubuntu安装VSCode platformio Python3.10（PlatformIO离线安装方法，安装失败问题、新建项目卡等问题）

参考资料：
PlatformIO离线安装终极方法
VSCode platformio 安装失败 首页一直 loading 成功解决

一、 安装VSCode

这里尽量使用网页内自动下面的VSCode，因为应用商店的用起来可能会出现问题

1. 下载VSCode_linux64_deb

2. 打开终端，切换至VSCode安装包下载路径

输入下面的命令

sudo dpkg -i code_1.89.1-1715060508_amd64.deb

运行时可以直接在命令行输出

code

二、安装 Python3.10

因为platformio使用时需要Python，故需单独安装

1. apt 安装相关依赖库

执行以下命令更新源：

sudo apt-get update

执行以下命令安装 Python3 的一些依赖库：

sudo apt-get install libqgispython3.10.4
sudo apt-get install libpython3.10-stdlib

2. 下载源码包

大家可以前往 Python 官网下载：Welcome to Pyhton! ，这里下载 gz 包和 xz 包都可以，下载链接如下：XZ compressed source tarball

也可使用 wget 下载，选一种方法即可：

wget -P ~/Downloads https://www.python.org/ftp/python/3.10.0/Python-3.10.0.tar.xz

接着解压 tar 包：

cd ~/Downloads
tar xvJf Python-3.10.0.tar.xz

到此，准备工作就做好啦！

3. 源码包安装 Python3.10

编译安装

首先进入我们刚才解压的文件目录下

cd ~/Downloads/Python-3.10.0

设置编译参数，即输出文件目录：

./configure --prefix=/usr/local/python3.10

接着实施编译：

make

上面两步都会有大量输出，可能需要等待两三分钟，编译完成后安装：

sudo make install

若出现如下输出，则说明安装成功：

Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.
Successfully installed pip-21.2.3 setuptools-57.4.0
WARNING: Running pip as the ‘root’ user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv

输入以下命令，检验 Python 配置是否成功：

python3 -V

三、 安装PlatformIO方法一

在拓展栏搜索PlatformIO并安装

如果你安装成功了，点击左侧的狐狸头，再点击open，即可出现下面的页面

如果你发现安装到一半，右下角卡着不动了，且是PlatformIO IDE (core)的问题，那么请你继续往下面看

众所周知，PlatformIO的资源服务器在国外，其资源包和更新包经常出现下载不了而导致PlatformIO Home界面无法启动的情况。

四、安装PlatformIO方法二

1. 删除platform IO如下图

先将上面code中下载的卸载掉

2. 在终端输入如下命令 重新安装

pip install -U https://github.com/platformio/platformio-core/archive/develop.zip

这里依据各自网速不同花费时间不同请耐心等待，如果能科学上网则很快。

实在不行的下载我这个

链接：https://pan.baidu.com/s/1Z2Oy25kb4SenswJfc9nYww?pwd=ttnf
提取码：ttnf
–来自百度网盘超级会员V6的分享

3. 更新

pip3 install –upgrade pip 
sudo apt-get upgrade

4. 检查是否成功

输入一下指令

pio home

此时会跳到下面的页面

终端中显示

5. vscode商城安装platform

此时发现vscode左侧并没有显示platform插件，只需去vscode插件商城安装platform ，即可在vscode里使用platform

五、设置PlatformIO IDE使用非内置core

1. 下载vsix：

通过https://marketplace.visualstudio.com/items?itemName=platformio.platformio-ide Vscode扩展市场下载 platformIO IDE 的vsix安装包。 下载 platformio vsix

2. 打开vscode，按下图选择 从VSIX安装… 安装上面下载的离线vsix文件。

选中文件即可

3. 设置PlatformIO IDE使用非内置core

打开设置
在搜索栏内输入platformio,右侧向下滚动找到在settings.json中编辑，点击打开json配置文件。

在配置文件内添加以下三条配置信息：

  "platformio-ide.useBuiltinPIOCore": false,
  "platformio-ide.useBuiltinPython": false,
  "platformio-ide.customPATH": "your python dir\\Script"

注意：：其中，customPATH为前面配置到path中的路径，根据实际安装位置确定。
可以使用which查看

lll@lll:~$ which pio
/home/lll/.local/bin/pio

4. 重新启动Vscode,即可打开platformIO ide

六、如果新建项目一直卡着

在你想新建的目录中打开终端输入下面的目录
这里会快速下载好需要的文件，等这个目录运行完后，再次新建就可以直接在code中完成

/home/lll/.local/bin/pio project init --board esp32doit-devkit-v1