安裝與環境設定

前面的課程都能直接在這個網站上執行，你不必先裝任何東西。但如果想在自己的電腦上寫程式，或做後面的 GUI、打包、爬蟲專題，就得在本機裝好 Python 和一個編輯器。

安裝 Python

我們用 uv 來安裝和管理 Python。uv 是一套很快的 Python 工具，一個指令就能裝好指定版本，日後要換版本也方便。

第一步：安裝 uv

依你的作業系統挑一條指令，貼到終端機執行。完整說明見 uv 的安裝文件。

macOS / Linux 在終端機執行：

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

Windows 在 PowerShell 執行：

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

如果你已經有慣用的套件管理器，也可以改用它安裝：

• macOS（Homebrew）：brew install uv
• Windows（WinGet）：winget install --id=astral-sh.uv -e
• Windows（Scoop）：scoop install main/uv
• 任何系統（pipx）：pipx install uv

裝完後關掉終端機、重新開一個，輸入 uv self version，有印出版本號就成功了。

第二步：用 uv 安裝 Python

本課程使用 Python 3.14。執行：

uv python install 3.14 --default

--default 會讓命令列的 python 指令直接指向這個版本。裝完後開一個新的終端機，輸入：

python -V

看到 Python 3.14.x 就代表裝好了。想知道電腦上裝了哪些版本，可以用 uv python list。更多用法見 uv 的安裝 Python 文件。

安裝編輯器

我們用 Visual Studio Code（簡稱 VS Code），免費、好上手，先到官網下載安裝。

建立課程專用的設定檔

VS Code 的設定檔（Profile）可以把一組擴充套件和設定獨立出來，不會動到你原本的環境。我們幫這門課開一個專用的：按 Ctrl + Shift + P、Mac 上是 Cmd + Shift + P，打開命令面板，輸入：

Profiles: New Profile

取個名字（像「Python Class」）建立，再切換過去。之後裝的套件和設定，都會留在這個設定檔裡。

裝擴充套件

在這個設定檔裡裝兩個擴充套件：

• Python（Microsoft）：語法提示、自動補全，還有除錯功能。
• Ruff（Astral）：檢查程式碼、自動排版、整理 import，一個套件就搞定。

貼上設定

打開命令面板，輸入：

Preferences: Open User Settings (JSON)

按 Enter 打開設定檔，把下面這段貼進去：

{
  "ruff.lineLength": 100,
  "[python]": {
    "editor.formatOnSave": true,
    "editor.codeActionsOnSave": {
      "source.fixAll": "explicit",
      "source.organizeImports": "explicit"
    },
    "editor.defaultFormatter": "charliermarsh.ruff"
  }
}

對照這段 JSON，各項設定的意思是：

• ruff.lineLength: 100：Ruff 排版時的行長上限。一行超過 100 個字元，Ruff 才會試著幫你折行。
• [python]：底下這些設定只套用在 Python 檔案，不影響其他語言。
  • editor.formatOnSave：每次存檔就自動排版。
  • editor.codeActionsOnSave：存檔時順手做的自動修正，包含下面兩項（值 explicit 代表只在你手動存檔時才執行）。
    • source.fixAll：修掉 Ruff 能自動修的問題，例如多餘的空白、沒用到的 import。
    • source.organizeImports：重新排列 import 的順序。
  • editor.defaultFormatter：指定 Python 檔案交給 Ruff 排版。

至於為什麼設成 100：Ruff 排版預設的行長上限是 88，而本課程的範例都以 100 排版。把編輯器也設成 100，你把範例貼進來、存檔後才不會被重新折行，變得跟網站上看到的不一樣。

想調更多設定，可以參考 Ruff 的 VS Code 擴充套件說明。