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

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

一、前期準備說明

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

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

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

• 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官方下載地址，根據自身操作系統(tǒng)選擇對應安裝包，截圖如下：

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

步驟2：運行Python安裝程序并配置

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

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

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

步驟3：驗證Python安裝成功

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

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

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

三、VSCode安裝與基礎配置教程

步驟1：下載VSCode安裝包

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

下載完成后，找到安裝包（默認存放在“下載”文件夾），雙擊啟動安裝程序。

步驟2：安裝VSCode并配置基礎選項

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

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

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

點擊插件右側「Install」安裝，安裝完成后，VSCode右下角會彈出重啟提示，點擊「Restart Now」重啟VSCode，截圖如下：

重啟完成后，VSCode界面變?yōu)橹形?，配置生效，截圖如下：

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

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

點擊搜索結果中的「編輯 in settings.json」（若未找到該選項，直接點擊「設置」界面右上角的「打開設置（JSON）」圖標），截圖如下：

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

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

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

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

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

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

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

五、配置總結

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

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

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

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

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

最新評論