哈嘍，各位嵌入式小伙伴、開發(fā)者朋友們～

本文將詳細(xì)講解Python（3.9.10版本）安裝與VSCode配置全流程，適配ESP32-S3開發(fā)環(huán)境需求，每一步均搭配截圖說明，標(biāo)注操作重點(diǎn)和避坑點(diǎn)，新手可直接對(duì)照操作，確保一次配置成功，為后續(xù)ESP-IDF環(huán)境搭建奠定基礎(chǔ)。

一、前期準(zhǔn)備說明

本次教程適配所有主流操作系統(tǒng)（Windows 10/11、macOS 11.0+、Debian/Ubuntu），核心工具版本如下，嚴(yán)格遵循此版本可避免后續(xù)兼容性問題：

• Python：3.9.10（bugfix版本，穩(wěn)定性最優(yōu)，與ESP-IDF工具鏈適配性強(qiáng)）
• VSCode：1.80.0及以上（免費(fèi)開源，無需破解，支持跨平臺(tái)）

工具下載地址（可直接復(fù)制訪問）：

• Python 3.9.10：https://www.python.org/downloads/release/python-3910/
• VSCode：https://code.visualstudio.com/Download

二、Python 3.9.10 安裝教程（每步帶截圖）

步驟1：下載Python 3.9.10安裝包

打開Python 3.9.10官方下載地址，根據(jù)自身操作系統(tǒng)選擇對(duì)應(yīng)安裝包，截圖如下：

截圖說明：截圖中可看到Python 3.9.10的所有可用安裝包，Windows用戶直接點(diǎn)擊「Windows installer (64-bit)」下載（推薦64位系統(tǒng)），macOS用戶點(diǎn)擊「macOS 64-bit universal2 installer」，下載完成后找到安裝包（默認(rèn)存放在“下載”文件夾）。

步驟2：運(yùn)行Python安裝程序并配置

1. 雙擊下載好的Python安裝包，啟動(dòng)安裝程序，首先勾選「Add Python 3.9 to PATH」（關(guān)鍵步驟，避免后續(xù)配置路徑），截圖如下：

2. 勾選完成后，點(diǎn)擊「Install Now」（默認(rèn)安裝，新手推薦），若需自定義安裝路徑，點(diǎn)擊「Customize installation」，截圖如下：

3. 若選擇自定義安裝，后續(xù)步驟保持默認(rèn)即可（無需修改任何組件），點(diǎn)擊「Next」直至安裝完成。

步驟3：驗(yàn)證Python安裝成功

安裝完成后，關(guān)閉安裝程序，按下「Win+R」打開運(yùn)行窗口，輸入「cmd」并回車，打開命令提示符。

在命令提示符中輸入「python --version」，若顯示「Python 3.9.10」，則說明安裝成功，截圖如下：

補(bǔ)充驗(yàn)證：輸入「pip --version」，顯示pip版本（默認(rèn)配套Python 3.9.10），說明pip工具也已正常安裝，后續(xù)可用于安裝依賴包。

三、VSCode安裝與基礎(chǔ)配置教程

步驟1：下載VSCode安裝包

打開VSCode官方下載地址，根據(jù)自身操作系統(tǒng)選擇對(duì)應(yīng)版本，截圖如下：

下載完成后，找到安裝包（默認(rèn)存放在“下載”文件夾），雙擊啟動(dòng)安裝程序。

步驟2：安裝VSCode并配置基礎(chǔ)選項(xiàng)

• 啟動(dòng)VSCode安裝程序，點(diǎn)擊「下一步」，勾選「我接受協(xié)議」，繼續(xù)點(diǎn)擊「下一步」。
• 選擇VSCode安裝路徑（建議默認(rèn)路徑，若自定義，需確保無中文、無空格），點(diǎn)擊「下一步」。
• 勾選基礎(chǔ)配置選項(xiàng)（推薦全部勾選），點(diǎn)擊「下一步」。
• 點(diǎn)擊「安裝」，等待安裝完成（約1~2分鐘），安裝完成后勾選「運(yùn)行Visual Studio Code」，點(diǎn)擊「完成」啟動(dòng)VSCode。

步驟3：VSCode中文界面配置（可選，新手推薦）

啟動(dòng)VSCode后，默認(rèn)是英文界面，按下快捷鍵「Ctrl+Shift+X」打開擴(kuò)展面板，搜索「Chinese (Simplified) Language Pack for Visual Studio Code」插件，截圖如下：

點(diǎn)擊插件右側(cè)「Install」安裝，安裝完成后，VSCode右下角會(huì)彈出重啟提示，點(diǎn)擊「Restart Now」重啟VSCode，截圖如下：

重啟完成后，VSCode界面變?yōu)橹形模渲蒙?，截圖如下：

步驟4：VSCode關(guān)聯(lián)Python環(huán)境（核心配置）

• 打開VSCode，依次點(diǎn)擊頂部菜單欄「文件」→「首選項(xiàng)」→「設(shè)置」，打開設(shè)置界面，截圖如下：
• 重點(diǎn)說明：部分VSCode版本（1.80.0及以上）已取消「python.pythonPath」配置項(xiàng)，若搜索不到該選項(xiàng)，無需擔(dān)心，按以下步驟操作（適配所有版本）：

點(diǎn)擊搜索結(jié)果中的「編輯 in settings.json」（若未找到該選項(xiàng)，直接點(diǎn)擊「設(shè)置」界面右上角的「打開設(shè)置（JSON）」圖標(biāo)），截圖如下：

在settings.json配置文件中，添加Python安裝路徑（適配兩種配置寫法，任選其一即可），示例如下（替換為自身實(shí)際安裝路徑），添加完成后保存文件（快捷鍵「Ctrl+S」），截圖如下：
{ // 寫法1：適配新版本VSCode（推薦） "python.defaultInterpreterPath": "F:\\python\\python.exe",, // 寫法2：適配舊版本VSCode（兼容原配置） "python.pythonPath": "F:\\Python\\python.exe" }
補(bǔ)充說明：兩種寫法可同時(shí)添加，確保適配所有VSCode版本，路徑需與Python實(shí)際安裝路徑一致，路徑中雙反斜杠不可省略。

關(guān)閉VSCode并重新啟動(dòng)，確保Python環(huán)境關(guān)聯(lián)生效，重啟后驗(yàn)證：依次點(diǎn)擊「查看」→「終端」，打開終端，輸入「python --version」，顯示「Python 3.9.10」，說明關(guān)聯(lián)成功，截圖如下：

四、常見問題及解決方案（附截圖提示）

1. 問題1：Python安裝后，命令提示符輸入「python --version」提示“不是內(nèi)部或外部命令”

解決方案：重新運(yùn)行Python安裝程序，確保勾選「Add Python 3.9 to PATH」，若已安裝未勾選，可重新安裝并勾選，或手動(dòng)配置環(huán)境變量（新手推薦重新安裝），截圖如下：

• 問題2：VSCode中文插件安裝后，界面未切換為中文
• 解決方案：安裝完成后未重啟VSCode，重啟后即可切換；若重啟后仍未切換，可依次點(diǎn)擊「管理」→「命令面板」，輸入「Configure Display Language」，選擇「zh-cn」，重啟VSCode即可。
• 問題3：VSCode配置Python路徑后，終端提示“Python路徑錯(cuò)誤”

解決方案：檢查settings.json中的路徑是否正確，確保路徑無中文、無空格，且與Python實(shí)際安裝路徑一致（可通過命令提示符輸入「where python」查詢實(shí)際路徑），修改后保存并重啟VSCode。

五、配置總結(jié)

本文完成了Python 3.9.10安裝與VSCode基礎(chǔ)配置，每一步均搭配截圖說明，核心要點(diǎn)的是：勾選Python的PATH選項(xiàng)、確保VSCode關(guān)聯(lián)正確的Python路徑，避免中文和空格路徑，這是后續(xù)ESP-IDF環(huán)境搭建的基礎(chǔ)。

下一篇我們將基于本次配置的環(huán)境，講解ESP-IDF插件安裝與工具鏈配置，逐步推進(jìn)ESP32-S3開發(fā)環(huán)境搭建，實(shí)現(xiàn)工程編譯與調(diào)試。

?? 資料獲?。篜ython 3.9.10安裝備用包已上傳至配套資源中，如有需要可自行下載。也可關(guān)注博主后留言獲取。

? 收藏本專欄，后續(xù)將持續(xù)更新ESP32-S3軟件實(shí)戰(zhàn)內(nèi)容，每篇均帶詳細(xì)步驟和截圖，助力新手快速上手嵌入式開發(fā)！??

到此這篇關(guān)于Python安裝與VSCode配置完整圖文教程的文章就介紹到這了,更多相關(guān)Python安裝與VSCode配置內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論