所有入門單元免費開放 · 課程內容持續更新中

安裝 Python 與 VS Code

在 Windows 或 macOS 上裝好 Python 和 VS Code,學會打開終端機,並執行你的第一個 hello.py。

第 1.2 堂約 12 分鐘

先搞懂三樣東西

開始安裝前,先分清楚你要裝的是什麼:

名稱 是什麼 比喻
Python 讀懂並執行 Python 程式的軟體 廚師
VS Code 寫程式用的編輯器 寫食譜的筆記本
終端機 用文字下指令給電腦的視窗 對廚房喊單的窗口

你在 VS Code 寫好程式(食譜),再透過終端機叫 Python(廚師)照著做。

三個方塊由左到右:VS Code 編輯器寫 hello.py、終端機輸入 python hello.py、Python 一行一行執行

步驟一:安裝 Python

Windows

  1. 打開 python.org,點上方的 Downloads,下載最新的 Python 3 版本(3.12 或更新)。
  2. 執行下載好的安裝檔。
  3. 在第一個畫面最下方,勾選「Add python.exe to PATH」,再按 Install Now。
  4. 等它裝完,按 Close。

macOS

  1. 打開 python.org,下載 macOS 版的最新 Python 3 安裝檔(.pkg)。
  2. 雙擊安裝檔,一路按「繼續」完成安裝。
  3. macOS 內建的指令名稱是 python3,後面的範例中,Mac 使用者請把 python 換成 python3。

步驟二:打開終端機,確認安裝成功

  • Windows:按開始鍵,搜尋「PowerShell」或「終端機」,打開它。
  • macOS:按 Command + 空白鍵,輸入「終端機」或 Terminal,按 Enter。

在終端機輸入下面的指令,按 Enter:

python --version

Mac 請輸入:

python3 --version

如果看到類似這樣的結果,就代表成功了(數字可能不同):

Python 3.13.1

步驟三:安裝 VS Code 與 Python 擴充功能

  1. 到 code.visualstudio.com 下載並安裝 VS Code。
  2. 打開 VS Code,點左側那個「四個方塊」的圖示(擴充功能)。
  3. 搜尋「Python」,安裝由 Microsoft 發布的那一個。

步驟四:寫出並執行 hello.py

  1. 在桌面或文件資料夾建立一個新資料夾,例如 python-practice。
  2. 在 VS Code 選「檔案」→「開啟資料夾」,打開它。
  3. 新增檔案,命名為 hello.py(副檔名 .py 很重要)。
  4. 輸入以下內容並存檔:
print("哈囉,我的第一支程式!")
print("今天也要記得記帳。")
  1. 按右上角的三角形「執行」按鈕,或在 VS Code 選「終端機」→「新增終端」,輸入:
python hello.py

你應該會看到:

哈囉,我的第一支程式!
今天也要記得記帳。

VS Code 示意畫面:左側檔案總管有 hello.py,編輯區有兩行 print,右上角是執行三角形,下方終端機顯示執行結果

VS Code 的版面:左邊是檔案,中間寫程式,下面是終端機。

卡住了?讓 AI 幫你看

安裝是新手最容易卡關的地方,因為每台電腦狀況都不太一樣。你可能會卡在這裡,這很正常。這時候打開 Claude(claude.ai,或你習慣的 ChatGPT、Gemini 也可以),把狀況告訴它,但你要給它足夠的資訊。

可以這樣問 AI

我是程式新手,用的是 Windows 11。我已經從 python.org 安裝了 Python,但在 PowerShell 輸入 python –version 之後出現下面這段訊息:

(把完整的錯誤訊息貼在這裡)

請一步一步告訴我可能的原因和解決方法,每一步都說明要點哪裡、輸入什麼。

記住兩個原則:錯誤訊息要完整貼上,不要只說「它壞了」;告訴 AI 你的作業系統。AI 給的指令如果你看不懂在做什麼,先問它「這行指令會對我的電腦做什麼」,確定了再執行。

行動練習
  1. 確認 python --version(Mac 是 python3 --version)可以顯示版本號。
  2. 建立 hello.py,讓它印出三行字:你的名字、你今天午餐吃什麼、你想用 Python 做的一件事。
  3. 在終端機執行它,截圖留念。這是你的第一支程式。

讀完了嗎?

標記完成後,單元與專案的進度會自動更新(只存在這台裝置的瀏覽器)。

卡住了?讓 AI 當你的家教複製這段提問範本,貼到 Claude 或其他 AI 工具,再補上你卡住的地方。

留言與討論

卡關了、有心得,或發現內容需要更新?都歡迎留言。留言使用 GitHub 帳號登入。

留言區即將開放。現在可以先到 GitHub 討論區 發問,或看看 交流頁 的其他管道。