從零開始：Windows 安裝 VS Code + Python，寫出你的第一支程式

步驟 1：下載並安裝 Visual Studio Code

VS Code 是微軟出的免費編輯器，目前最新版本是 1.127（2026 年 7 月釋出）。到官方下載頁 code.visualstudio.com/download，頁面會依你的作業系統顯示對應的下載按鈕，Windows 使用者選 Windows 那顆按鈕（預設抓 x64 版本，一般電腦都適用）。

下載完是一個 .exe 安裝檔，直接執行後照精靈跑：

- 第一頁：勾選同意授權條款，按 Next。 - 走到「Select Additional Tasks」這一頁，會看到幾個核取方塊，建議勾法： - Add "Open with Code" action to Windows Explorer file context menu（在檔案總管對檔案按右鍵可以直接用 VS Code 開） - Add "Open with Code" action to Windows Explorer directory context menu（對資料夾按右鍵也可以直接開） - Register Code as an editor for supported file types - Add to PATH（這個一定要勾，之後才能在終端機直接打 code 指令開啟 VS Code） - 按 Install，跑完按 Finish，預設會直接開啟 VS Code（先別急著用它——下一步裝完 Python 後需要重開一次，詳見步驟 2 說明）。

[截圖建議：VS Code 安裝精靈「Select Additional Tasks」頁面，標出 Add to PATH 核取方塊]

步驟 2：安裝 Python 本身

VS Code 只是編輯器，它不會寫程式，真正負責「看懂並執行」Python 程式碼的是 Python 直譯器，這一套要另外裝。到官方下載頁 python.org/downloads，目前最新穩定版是 Python 3.14.6（2026 年 6 月釋出）。

頁面上會看到兩個選項：一個是「Python install manager」（透過 Microsoft Store 安裝、之後用 py 指令管理多個版本），另一個是「standalone installer」也就是傳統安裝檔 python-3.14.6-amd64.exe。對第一次安裝的新手來說，standalone installer 步驟比較單純，這篇用這個版本示範（提醒：官方文件已標註傳統安裝檔從 3.14 版起進入淘汰階段、3.16 版後就不會再提供，如果你之後跟著更新版教學走，看到只剩 install manager 選項是正常的）。

下載後執行安裝檔：

• 第一頁最下方有一個核取方塊寫著 Add python.exe to PATH，這個一定要勾——沒勾的話，之後在終端機打 python 會出現「'python' is not recognized」的錯誤。
• 勾好之後直接點 Install Now（一般個人電腦用這個就夠，不需要點 Customize installation）。
• 跑完按 Close。

[截圖建議：Python 安裝精靈第一頁，標出 Add python.exe to PATH 核取方塊位置]

注意：如果 VS Code 是在裝 Python 之前就已經開著（例如剛做完步驟 1 它自動開啟），這裡請先把 VS Code 所有視窗完全關閉、再重新打開，這樣它才讀得到剛剛更新的 PATH，不然下一步打 python --version 大機率會出現 'python' is not recognized 的錯誤——這不是你操作錯誤，而是已經在跑的程式不會自動重新讀取剛更新的環境變數。

確認 VS Code 是「裝完 Python 之後」重新開啟的，用選單 Terminal → New Terminal（或快捷鍵 ` Ctrl+ ``）叫出終端機，輸入：

python --version

步驟 3：安裝 VS Code 的 Python 擴充套件

VS Code 預設不認得 Python 語法，需要裝微軟官方的 Python 擴充套件才會有語法上色、自動完成、還有等一下要用的「執行」按鈕。

在 VS Code 左側按 Extensions 圖示（四個方塊拼在一起的那個），或按快捷鍵 Ctrl+Shift+X 叫出擴充套件面板。在搜尋框打 python，第一個結果應該是發布者為 Microsoft 的 Python 擴充套件（套件全名 ms-python.python），點進去按 Install。

[截圖建議：Extensions 面板搜尋 python，標出 Microsoft 官方 Python 擴充套件與 Install 按鈕]

裝完之後，開啟任何一個 .py 檔案，VS Code 右下角狀態列會出現目前使用的 Python 版本（例如 3.14.6）。如果顯示不太對，或你電腦上裝了不只一個 Python 版本，可以按 Ctrl+Shift+P 叫出命令面板，輸入 Python: Select Interpreter，從清單裡選剛才裝好的 3.14.6。

步驟 4：寫出你的第一支程式

在 VS Code 裡用選單 File → New File，選 Python File（或直接存檔時把副檔名打成 .py），存成 hello.py。貼上這段程式碼：

name = input("你叫什麼名字？")
print(f"哈囉，{name}！歡迎開始學 Python。")

for i in range(1, 4):
    print(f"這是第 {i} 次打招呼")

這段程式做三件事：讀使用者輸入、用 f-string 組字串印出來、再用迴圈印三次——涵蓋了新手最先會用到的三個基本功。

步驟 5：正確執行程式（不要再雙擊了）

存檔後，編輯器視窗右上角會出現一個三角形播放鍵，滑鼠移上去會顯示「Run Python File」，直接點下去。VS Code 會自動在下方開啟一個終端機分頁，執行 python hello.py，程式的輸出（包含要你輸入名字的提示）會顯示在這個終端機裡，而且執行完視窗不會關掉，你可以看到完整結果。

[截圖建議：VS Code 編輯器右上角 Run Python File 播放鍵，以及下方終端機顯示的執行結果]

如果終端機卡在等你輸入名字，直接在終端機裡打字、按 Enter 就會繼續往下跑。跑完你會看到類似這樣的輸出：

你叫什麼名字？小明
哈囉，小明！歡迎開始學 Python。
這是第 1 次打招呼
這是第 2 次打招呼
這是第 3 次打招呼

另一種等效的做法：在終端機裡自己手動輸入 python hello.py 執行，效果跟按播放鍵一樣，差別只是播放鍵幫你把這行指令打好了。這也是為什麼一開始雙擊檔案看不到結果——雙擊是直接叫系統執行完就關掉視窗，跟在終端機裡執行、視窗留著讓你看結果，是兩件不同的事。

常見卡點

• 打 `python` 沒反應或說找不到指令：回到步驟 2，重新執行安裝檔，這次確定勾 Add python.exe to PATH，裝完要整個關掉 VS Code 再重開一次終端機才會生效。
• VS Code 沒有語法上色、沒有播放鍵：代表步驟 3 的 Python 擴充套件沒裝成功，回 Extensions 面板確認擴充套件狀態是 Installed 不是還在下載中。
• 右下角版本跟你想的不一樣：電腦上如果裝過不只一個 Python（例如之前用 Anaconda 裝過一次），用 Ctrl+Shift+P 打開 Python: Select Interpreter 手動選對版本。

環境裝好只是第一步，真正要熟悉變數、迴圈、函式這些基本語法，還是需要照順序練習——如果你是完全從零開始，可以接著看 Python 基礎課程，從變數和資料型別開始練起。