我的Windows10上的python環境是免安裝直接解壓的Python3.8.x老版本，可參見《Windows下Python3.8環境快速安裝部署。
1. 安裝VSCode
在Windows 10系統上安裝Visual Studio Code（VS Code）是一個簡單的過程，以下是詳細的安裝方法與步驟：
1.1. 下載VS Code安裝包
-
訪問官方下載頁面
打開瀏覽器，訪問VS Code官方下載地址：
https://code.visualstudio.com/Download -
選擇Windows版本
在頁面中找到Windows圖標，點擊下載按鈕（默認下載User Installer）。- 如需
System Installer，點擊頁面底部的Other Downloads，選擇Windows System Installer。
- 如需
1.2. 安裝VS Code
-
運行安裝程序
雙擊下載的.exe文件，啟動安裝向導。 -
接受許可協議
勾選I accept the agreement，點擊Next。 -
選擇安裝路徑（可選）
- 默認路徑：
C:\Users\{用戶名}\AppData\Local\Programs\Microsoft VS Code（用戶安裝）或C:\Program Files\Microsoft VS Code（系統安裝）。 - 可通過
Browse自定義路徑，但需確保目標文件夾有寫入權限。
- 默認路徑：
-
選擇附加任務
- 創建桌面快捷方式：勾選后會在桌面生成圖標。
- 添加到PATH（用戶級）：勾選后可在命令行直接運行
code命令（需重啟終端生效）。 - 注冊為默認文本編輯器：勾選后雙擊
.txt等文件將用VS Code打開。
建議：勾選全部選項以提升便利性。
-
開始安裝
點擊Install，等待安裝完成（約1-2分鐘）。 -
完成安裝
勾選Launch Visual Studio Code后點擊Finish，VS Code將自動啟動。
1.3. 首次配置與優化
-
安裝必要擴展
- 打開擴展商店（
Ctrl+Shift+X），搜索并安裝常用擴展：- 編程語言支持：如Python、C++、Java等。
- 工具類擴展：GitLens（Git集成）、Prettier（代碼格式化）、ESLint（代碼檢查）。
- 主題/圖標：如One Dark Pro、Material Icon Theme。
- 打開擴展商店（
-
設置用戶偏好
- 打開設置（
Ctrl+,），調整以下選項：- 字體：推薦
Consolas、Fira Code（需單獨安裝）或Cascadia Code。 - 縮進：設置
Tab Size為2或4，勾選Insert Spaces。 - 文件自動保存：啟用
Auto Save（推薦afterDelay模式）。
- 字體：推薦
- 打開設置（
-
啟用Git集成（可選）
- 確保已安裝Git（下載地址）。
- 在VS Code中打開Git倉庫目錄，側邊欄將自動顯示Git面板。
-
配置終端
- 默認終端為PowerShell，可切換為CMD或Git Bash：
- 打開設置，搜索
Terminal > Integrated: Default Profile，選擇對應終端。
- 打開設置，搜索
- 默認終端為PowerShell，可切換為CMD或Git Bash：
通過上述步驟，你可以在Windows 10上順利安裝并配置VS Code。安裝后，建議根據個人需求安裝擴展、調整設置，并定期更新VS Code（自動更新功能默認啟用）以獲取最新功能和安全修復。
2. 開發調試python入門
2.1. 安裝Python擴展
VS Code 與 Python 插件的集成主要通過 Microsoft 官方提供的 Python 擴展 實現，該擴展深度整合了代碼編輯、調試、虛擬環境管理等功能。以下是集成原理、自行安裝步驟及限制要求的詳細說明：
2.1.1. VS Code 與 Python 插件的集成原理
-
核心擴展：Python 官方插件
- 由 Microsoft 開發，提供基礎功能（語法高亮、智能提示、代碼格式化、調試支持）。
- 內置 Pylance 語言服務器（可選），支持類型檢查、快速補全和智能感知，尤其適合大型項目。
-
調試與運行支持
- 內置調試器（Python Debugger）支持斷點調試、變量監控和調用堆棧分析。
- 支持直接運行
.py文件或 Jupyter Notebook（通過 Jupyter 擴展）。
-
環境管理
- 自動檢測已安裝的 Python 解釋器（包括虛擬環境和 Conda 環境，如果是解壓包自行配置方式，需要人工指定配置）。
- 支持在 VS Code 內創建/切換虛擬環境，避免全局包沖突。
-
測試與協作
- 支持 unittest、pytest 等測試框架，可直接在 VS Code 中運行測試用例。
- 集成 Git，方便代碼版本管理。
2.1.2. 自行安裝 Python 插件的步驟
- 通過擴展市場安裝
- 打開 VS Code，點擊左側活動欄的 擴展圖標（或按
Ctrl+Shift+X）。 - 搜索 Python，選擇由 Microsoft 發布的擴展，點擊 安裝。
- 安裝完成后，VS Code 可能提示重啟以生效。
- 打開 VS Code，點擊左側活動欄的 擴展圖標（或按
點擊擴展安裝python的“Install”，將自動安裝Python Debugger和Pylance，稍后將在已經安裝的擴展中看到。
2.1.3. 配置 Python 解釋器
- 打開一個 Python 文件（或新建
.py文件）。 - VS Code 右下角會提示 選擇 Python 解釋器，點擊后從列表中選擇已安裝的 Python 版本。
- 若未列出，需檢查 Python 是否已正確安裝并添加到系統環境變量。
- 也可通過命令面板（
Ctrl+Shift+P）輸入 Python: Select Interpreter 手動選擇。
2.1.4. 驗證安裝
- 創建一個簡單的 Python 文件（如
test.py），輸入以下代碼：print("Hello, VS Code with Python!") - 右鍵點擊編輯器，選擇 Run Python File in Terminal，若終端輸出正確結果，則安裝成功。
2.1.5. 推薦搭配的插件
-
代碼質量工具
- Ruff：語法檢查與格式化（替代 Flake8/Black）。
- Pylint：靜態代碼分析。
- Black Formatter：自動格式化代碼。
-
效率工具
- Python Docstring Generator：快速生成文檔字符串。
- GitHub Copilot：AI 輔助編程（需訂閱）。
-
環境管理
- Python Environment Manager：集中管理虛擬環境。
2.1.6. 常見問題解決**
-
插件安裝失敗
- 檢查網絡連接或嘗試離線安裝。
- 確保 VS Code 已更新至最新版本。
-
Python 解釋器未檢測到
- 手動指定解釋器路徑（通過命令面板輸入 Python: Select Interpreter）。
- 重新安裝 Python 并勾選 Add to PATH。
-
調試功能無法使用
- 確保安裝了 Python Debugger（通常隨 Python 插件自動安裝）。
- 檢查
launch.json配置是否正確。
通過以上步驟，你可以輕松在 VS Code 中集成 Python 開發環境，并根據需求擴展功能。若需進一步優化，可參考 VS Code 官方 Python 文檔。
2.2. 實踐過程
2.2.1. 調試器（代碼跟蹤）無法正常工作
調試配置和解釋器路徑看起來是正確的，但調試器仍然無法正常工作。以下是可能的原因和進一步的排查步驟：
- 確認 debugpy 已安裝
問題：debugpy 是 VS Code Python 調試器的后端依賴，如果未安裝或版本不兼容，調試會失敗。
解決方案：在終端中運行以下命令安裝/更新 debugpy：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple debugpy
- 檢查 Python 解釋器路徑
驗證路徑：
確保 D:/Python/Python38/python 是有效的 Python 解釋器路徑。
在終端中運行：
D:/Python/Python38/python --version
2.2.2. 手工指定Python解釋器
更新 settings.json 和 launch.json 中的路徑為絕對路徑（注意：在.vscode路徑下）。
- 顯式指定 Python 解釋器路徑配置文件launch.json
{"version": "0.2.0","configurations": [{"name": "Python 調試程序: 當前文件","type": "debugpy","request": "launch","program": "${file}","console": "integratedTerminal","python": "D:/Python/Python38/python"}]
}
- 在 settings.json 中配置默認解釋器：
{"python.defaultInterpreterPath": "D:/Python/Python38/python"
}
3. 總結
- 正確流程：必須先安裝 VS Code，再安裝 Python 擴展，無法跳過這一步驟。
- 原因：VS Code 的模塊化設計決定了其無法預裝所有語言支持，但通過擴展機制可靈活適配需求。
- 推薦方案：
- 安裝 VS Code。
- 安裝 Python 擴展 + 輔助插件（如 Ruff、Black）。
- 配置項目環境（虛擬環境 + requirements.txt）。
- Python環境一般需要補充調試依賴debugpy庫。
通過以上步驟，用戶可快速獲得一個高效、輕量的 Python 開發環境。如需進一步優化，可參考 VS Code 官方 Python 文檔。
