共用方式為

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

在 Windows 上幾分鐘內準備好你的 Python 環境——可以用 Winget 從命令列安裝，或手動設定。 您將需要下列項目：

  • Python – 目前穩定的Python執行環境（3.14 或更新版本）
  • Visual Studio Code – 輕量且強大的程式碼編輯器
  • Visual Studio Code 的 Python 擴充功能 – 增加對 Python 語言的支援、除錯、靜態程式檢查等功能

  1. 在 Windows 終端機 開啟 PowerShell 並安裝 Python：

    winget install Python.Python.3.14

  2. 安裝 Visual Studio Code：

    winget install Microsoft.VisualStudioCode

  3. 關閉並重新開啟 PowerShell，然後確認 Python 是否已安裝：

    python --version

  4. 打開 VS Code，安裝 VS Code 市集的 Python 擴充功能。

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

開始學Python

常見問題

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

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

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

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

請關注 StackOverflow 的討論

使用 WSL 安裝 PIP 的問題

當你在 Windows 子系統 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 查看可用版本。 HOWEVER，py.exe 啟動器只有在你使用從 python.org 安裝的版本Python時才會運作。當你從 Microsoft Store 安裝 Python 時，py 指令變成 not included。 對於 Linux、macOS、WSL 以及Python Microsoft Store 版本，你應該使用 python3（或 python3.7）指令。

為什麼執行 python.exe 會打開 Microsoft Store？

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

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

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

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

為什麼我複製貼上檔案路徑時，Python裡的路徑卻無法正常運作？

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

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

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

什麼是 PYTHONPATH？

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

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

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

不建議透過 Environment Variables 設定全域設定此變數，因為這樣可能會被任何版本的 Python 使用，而不是你打算使用的版本。

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

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

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

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

VS Code 內建 Settings Sync，讓你能透過GitHub或Microsoft 帳戶在不同機器間分享設定、按鍵綁定、擴充功能等功能。 不需要延期。

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

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

Mac 的快捷鍵怎麼對應到 Windows 的快捷鍵？

部分鍵盤按鈕和系統捷徑在 Windows 機和 Macintosh 之間略有不同。 這份Mac 轉 Windows 轉換指南 涵蓋了基本操作。

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