共用方式為

在 Windows 上架設你的 Python 開發環境

在 Windows 上幾分鐘內準備好你的 Python 環境——手動設定或用 winget 自動化所有操作。 您將需要下列項目：

  • Python 3.13 – 最新的 Python 執行環境
  • Visual Studio Code – 輕量且強大的程式碼編輯器
  • Visual Studio Code 的 Python 擴充功能 – 新增 Python 語言支援、除錯、靜態分析等功能

下面的 WinGet 設定檔 會自動安裝上述所有內容。

開始之前：

  1. 在 Windows 終端機開啟 PowerShell，並執行以下指令：

    winget configure -f https://aka.ms/python-config

  2. 當設定開始時，終端機視窗會顯示設定步驟和所需安裝步驟。 檢視這些內容後，選擇 [Y] 是或 [N] 否以繼續進行。

  3. 所需的工作負載已安裝完成。 透過執行 python --version. 來驗證你的設定。

你現在已經準備好開始 Python 開發了。

開始使用 Python

常見問題

安裝帶有 pip install 的套件時遇到問題

安裝失敗的原因有很多——在許多情況下，正確的解決方案是聯絡套件開發者。

常見的問題是試圖安裝到你沒有權限修改的位置。 例如，預設安裝地點可能需要管理員權限，但預設情況下 Python 不會有這些權限。 最好的解決方案是建立 一個虛擬環境 並安裝在那裡。

部分套件包含原生程式碼，需使用 C 或 C++ 編譯器才能安裝。 一般來說，套件開發者應該發布預先編譯的版本，但通常不會這麼做。 如果你 安裝 Visual Studio 的建置工具 並選擇 C++ 選項，這些套件中有些可能可行，但大多數情況下你需要聯絡套件開發者。

請關注 StackOverflow 的討論

使用 WSL 安裝 PIP 的問題

例如，在 Windows Subsystem for Linux（WSL 或 WSL2）上使用 pip 安裝套件（例如 Flask python3 -m pip install flask）時，你可能會遇到以下錯誤：

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None))
after connection broken by 'NewConnectionError('<urllib3.connection.VerifiedHTTPSConnection
object at 0x7f655471da30>: Failed to establish a new connection: [Errno -3]
Temporary failure in name resolution')': /simple/flask/

除非你有安裝第三方防火牆，否則最有可能的解決方法就是重新安裝 PIP：

sudo apt -y purge python3-pip
sudo python3 -m pip uninstall pip
sudo apt -y install python3-pip --fix-missing
什麼是 py.exe？

你可能會因為處理不同類型的 Python 專案，機器上安裝了多個版本的 Python。 因為這些都使用了 python 指令，所以哪個版本的 Python 正在被使用可能不太明顯。 作為標準，建議使用該 python3 指令（或 python3.7 選擇特定版本）。

py.exe 啟動器會自動選擇你安裝的最新版本 Python。 你也可以使用指令 py -3.7 選擇特定版本，或 py --list 查看可用版本。 不過，py.exe 啟動器只有在你使用 python.org 安裝的 Python 版本時才會有效。當你從 Microsoft Store 安裝 Python 時， py 這個指令 就不包含在內。 對於 Linux、macOS、WSL 以及 Microsoft Store 版本的 Python，你應該使用 python3 （或 python3.7） 指令。

為什麼執行 python.exe 會開啟 Microsoft 商店？

為了幫助新用戶找到良好的 Python 安裝，我們新增了一個 Windows 捷徑，能直接帶你進入 Microsoft Store 社群套件的最新版本。 此套件可輕鬆安裝，無需管理員權限，且會將預設的 python 和 python3 指令替換為實際的指令。

使用任何命令列參數執行捷徑執行檔時，會回傳錯誤代碼，表示未安裝 Python。 這是為了防止批次檔和腳本在可能不該開啟商店應用程式時。

如果你用 python.org 的安裝程式安裝 Python 並選擇「add 到 PATH」選項，新 python 指令會優先於捷徑。 請注意，其他安裝程式可能會以python內建捷徑的優先順序來新增。

你可以在不安裝 Python 的情況下關閉捷徑，方法是從開始開啟「管理應用程式執行別名」，找到「應用程式安裝程式」的 Python 項目並切換為「關閉」。

為什麼我在複製貼上檔案路徑時，Python 裡的路徑卻無法使用？

Python 字串使用特殊字元的「轉義」。 例如，要在字串中插入新行字元，你會輸入 \n。 由於 Windows 的檔案路徑使用反斜線，部分部分可能會被轉換成特殊字元。

要在 Python 中將路徑貼上成字串，請加上 r 前綴。 它表示這是一個raw 字串，除了雙引號之外，不會使用任何逃脫字元（你可能需要移除路徑中的最後一個反斜線）。 所以你的路徑可能會是： r"C:\Users\MyName\Documents\Document.txt"

在 Python 中處理路徑時，我們建議使用標準的 pathlib 模組。 這樣你就能將字串轉換成一個豐富的 Path 物件，無論使用斜線還是反斜線，都能穩定地進行路徑操作，讓你的程式碼在不同作業系統間運作得更好。

什麼是 PYTHONPATH？

PYTHONPATH 環境變數被 Python 用來指定一個可匯入模組的目錄清單。 執行時，你可以檢查變 sys.path 數，看看匯入時會搜尋哪些目錄。

若要從命令提示字元設定此變數，請使用： set PYTHONPATH=list;of;paths。

要在 PowerShell 設定這個變數，請在啟動 Python 前使用： $env:PYTHONPATH='list;of;paths'

不建議透過環境變數設定將此變數全域設定，因為任何版本的 Python 都可能使用此變數，而非你打算使用的版本。

我在哪裡可以找到打包和部署的協助？

Docker： VSCode 擴充功能 幫助你快速打包並部署 Dockerfile 和 docker-compose.yml 範本（產生適合你專案的 Docker 檔案）。

Azure Kubernetes Service（AKS） 讓您能部署和管理容器化應用程式，同時按需擴展資源。

如果我需要跨台機器工作怎麼辦？

設定同步 功能讓你能透過 GitHub 在不同安裝間同步你的 VS Code 設定。 如果你在不同機器上工作，這有助於保持環境在不同機器間的一致性。

如果我習慣使用 PyCharm、Atom、Sublime Text、Emacs 或 Vim，怎麼辦？

VSCode 擴充功能 Keymaps 能讓你的環境感覺如同賓至如歸。

Mac 的快捷鍵是如何映射到 Windows 的快捷鍵的？

Windows 機種和 Macintosh 的鍵盤按鈕和系統快捷鍵有些微差異。 這份 Mac 到 Windows 的過渡指南 涵蓋了基本內容。

我在哪裡可以學到更多關於在 VS Code 中使用 Python 的知識？
  • 在 VS Code 中編輯 Python：了解更多如何利用 VS Code 的自動補全功能與 IntelliSense 對 Python 的支援，包括如何自訂它們的行為......或者乾脆關掉它們。
  • Linting Python：Linting 是執行程式分析程式碼以找出潛在錯誤的過程。 了解 VS Code 如何為 Python 提供不同形式的程式碼檢查支援以及如何進行設定。
  • 除錯 Python：除錯是識別並移除電腦程式錯誤的過程。 本文將介紹如何使用 VS Code 初始化與設定 Python 除錯、如何設定與驗證斷點、附加本地腳本、針對不同應用程式類型或遠端電腦進行除錯，以及一些基本的故障排除。
  • 單元測試 Python：涵蓋單元測試的背景說明、範例攻略、啟用測試框架、建立與執行測試、除錯測試，以及測試設定。
  • Last updated on