Python 安裝與環境設定

Python 安裝（Python Installation）

這篇 Python 安裝教學將帶你在 Windows 或 macOS 上建立 Python 開發環境。我們不使用傳統的 python.org 安裝程式，而是採用 uv —— 一個以 Rust 開發的極速 Python 版本與套件管理工具。它已經成為 Python 社群的主流選擇，一個工具就能同時管理 Python 版本、虛擬環境與套件，之後的系列文章也都以這套環境為準。

安裝方式	優點	缺點
uv（本篇採用）	一個工具管理 Python 版本、虛擬環境、套件；速度極快；切換版本容易	需要先安裝 uv
python.org 安裝程式	官方、最傳統	版本切換麻煩，套件管理需另外處理
Microsoft Store / Homebrew	安裝方便	版本更新受平台控制，環境不易掌控

安裝 uv

Windows

打開 PowerShell（按 Win 鍵輸入 powershell），執行：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

macOS

打開「終端機」，執行：

curl -LsSf https://astral.sh/uv/install.sh | sh

安裝完成後關閉並重新開啟終端機，輸入以下指令確認安裝成功：

uv --version

執行輸出（版本號可能不同）：

uv 0.11.19

安裝 Python

uv 安裝好後，用一行指令安裝 Python。本系列以 Python 3.14 為準：

uv python install 3.14

執行輸出：

Installed Python 3.14.4 in 2.34s
 + cpython-3.14.4-windows-x86_64-none

確認 Python 可以執行：

uv run python --version

執行輸出：

Python 3.14.4

執行第一支 Python 程式

Python 程式是副檔名為 .py 的純文字檔。建立一個 hello.py，內容如下：

print("Hello, Python!")

在該檔案所在的資料夾執行：

uv run hello.py

執行輸出：

Hello, Python!

看到輸出就代表環境設定完成了。

互動模式（REPL）

除了執行檔案，也可以進入互動模式逐行測試程式碼，很適合快速驗證語法：

uv run python

Python 3.14.4 (main, Apr  7 2026) [...] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> 1 + 1
2
>>> print("測試")
測試
>>> exit()

編輯器：VS Code

寫 Python 推薦使用免費的 Visual Studio Code，安裝後到擴充功能（Extensions）搜尋並安裝微軟官方的 Python 擴充套件，即可獲得語法提示、自動完成與除錯功能。

常見錯誤

1. uv : 無法辨識 ‘uv’ 詞彙 或 command not found: uv

安裝完 uv 後沒有重新開啟終端機，PATH 環境變數尚未生效。關閉終端機重開即可；若仍無效，登出再登入一次系統。

2. PowerShell 顯示「因為這個系統上已停用指令碼執行」

Windows 的執行原則（Execution Policy）擋下了安裝腳本。請確認指令完整包含 -ExecutionPolicy ByPass，照本文的安裝指令複製貼上即可。

3. 輸入 python 沒反應或跳出 Microsoft Store

Windows 內建的 python 捷徑會導向 Microsoft Store。使用 uv 環境時，一律以 uv run python 執行即可，不需要理會系統的 python 指令。

總結

到這裡你已經完成：安裝 uv、安裝 Python 3.14、執行第一支程式。之後系列文章的所有範例，只要存成 .py 檔用 uv run 執行，或貼進 REPL 都能直接測試。下一篇我們正式進入 Python 的基本語法與註解。

延伸閱讀

• Python 教學（系列目錄）
• Python 基本語法與註解（下一篇）
• Python 虛擬環境與 uv 套件管理（第 24 篇）