SEARCH

vscode安裝python: 您的Python開發環境搭建指南

2025-07-12 21:40:51

為什麼選擇 VS Code 安裝 Python？

Visual Studio Code (VS Code) 是一款輕量級但功能強大的源代碼編輯器，由微軟開發，支持 Windows、macOS 和 Linux。它憑藉其豐富的擴展生態系統、智能代碼補全（IntelliSense）、內置 Git 支持以及強大的調試功能，成為了現代開發者，尤其是 Python 開發者，首選的開發工具之一。

本篇文章將為您詳細介紹如何在 VS Code 中高效地安裝和配置 Python 開發環境，確保您能夠順利地編寫、運行和調試 Python 代碼。

第一步：安裝 Visual Studio Code

如果您尚未安裝 VS Code，請按照以下步驟進行：

  1. 下載 VS Code： 訪問 VS Code 官方網站 (code.visualstudio.com)，根據您的操作系統（Windows、macOS 或 Linux）下載對應的安裝包。
  2. 運行安裝程序： 雙擊下載的安裝包並按照提示進行安裝。
    • 在 Windows 上，建議勾選「添加到 PATH」選項，以便在命令行中直接啟動 VS Code。
    • 在 macOS 上，將 VS Code 應用程序拖放到「應用程序」文件夾中。
    • 在 Linux 上，通常通過包管理器進行安裝（例如 Debian/Ubuntu 使用 sudo apt install code，Fedora 使用 sudo dnf install code）。
  3. 啟動 VS Code： 安裝完成後，啟動 VS Code。您將看到其歡迎界面。

第二步：安裝 Python 解釋器

VS Code 本身並不包含 Python 解釋器。您需要單獨安裝 Python 解釋器，然後 VS Code 才能使用它來運行您的代碼。

  1. 下載 Python： 訪問 Python 官方網站 (python.org)，在「Downloads」部分下載最新穩定版本的 Python。建議下載 3.x 系列的最新版本。
  2. 運行安裝程序：
    • Windows 用戶：

      運行下載的 .exe 安裝程序。非常重要的一步是： 在安裝嚮導的第一步，請務必勾選「Add Python to PATH」選項。這將自動配置環境變數，使您可以在任何命令行位置運行 Python。然後選擇「Install Now」進行標準安裝。

    • macOS 用戶：

      運行下載的 .pkg 安裝程序。按照提示完成安裝即可。macOS 通常會預裝一個舊版本的 Python 2，但您安裝的 Python 3 不會覆蓋它，而是會并行存在。建議使用 python3 命令來運行新安裝的 Python 3。

    • Linux 用戶：

      大多數 Linux 發行版都預裝了 Python。如果需要安裝特定版本，可以使用發行版的包管理器（例如 sudo apt install python3 或 sudo yum install python3）。

  3. 驗證安裝：

    打開一個命令行窗口（Windows: cmd 或 PowerShell, macOS/Linux: 終端），輸入以下命令並按回車：

    python --version

    或

    python3 --version

    如果顯示了 Python 的版本號（例如 Python 3.9.7），則表示 Python 解釋器已成功安裝。

第三步：在 VS Code 中安裝 Python 擴展

Python 擴展是 VS Code 支持 Python 開發的核心。它提供了代碼補全、語法高亮、調試、虛擬環境管理等一系列功能。

  1. 打開擴展視圖： 在 VS Code 的側邊欄中，點擊「擴展」圖標（通常是四個方塊組成的正方形）。您也可以使用快捷鍵 Ctrl+Shift+X (Windows/Linux) 或 Cmd+Shift+X (macOS)。
  2. 搜索 Python 擴展： 在搜索框中輸入「Python」。
  3. 安裝擴展： 找到由 Microsoft 提供的「Python」擴展。點擊其右側的「安裝」按鈕。
  4. 等待安裝完成： 安裝過程可能需要一些時間，取決於您的網路速度。安裝完成後，按鈕會變為「禁用」和「卸載」。

第四步：配置 Python 解釋器

安裝完 Python 擴展后，您需要告訴 VS Code 使用哪個 Python 解釋器來運行您的項目。

  1. 打開命令面板： 在 VS Code 中，按下 Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (macOS) 打開命令面板。
  2. 選擇解釋器： 在命令面板中輸入「Python: Select Interpreter」（或者只輸入「Python: S」即可看到提示），然後選擇它。
  3. 選擇解釋器路徑： VS Code 會自動檢測您系統上已安裝的 Python 解釋器。選擇您剛剛安裝的 Python 3.x 版本（通常會顯示其路徑，例如 Python 3.9.7 64-bit）。

    如果您有多個 Python 版本或虛擬環境，您可以選擇特定的解釋器。如果沒有自動檢測到，您也可以選擇「Enter interpreter path...」然後手動指定 Python 解釋器的完整路徑。

  4. 確認： 選擇后，您會在 VS Code 窗口的左下角狀態欄看到當前選定的 Python 解釋器版本，例如「Python 3.9.7」。這表明配置成功。

第五步：運行你的第一個 Python 程序

現在，一切都已設置完畢，讓我們來運行一個簡單的 Python 程序。

創建 Python 文件

  1. 新建文件： 在 VS Code 中，點擊「文件」菜單 -> 「新建文件」，或者使用快捷鍵 Ctrl+N (Windows/Linux) / Cmd+N (macOS)。
  2. 編寫代碼： 在新打開的編輯器中輸入以下 Python 代碼：

    print("Hello, VS Code Python!")

  3. 保存文件： 點擊「文件」菜單 -> 「保存」 (Ctrl+S / Cmd+S)。將文件保存為一個以 .py 結尾的名字，例如 hello.py。

運行 Python 程序

有幾種方法可以在 VS Code 中運行 Python 文件：

  • 使用運行按鈕： 在編輯器窗口的右上角，您會看到一個綠色的「運行」按鈕（三角形圖標）。點擊它，Python 代碼將在 VS Code 的內置終端中執行。
  • 右鍵菜單： 在編輯器中右鍵點擊代碼區域，選擇「在終端中運行 Python 文件」。
  • 通過終端手動運行：
    1. 打開終端： 點擊 VS Code 菜單欄的「終端」 -> 「新建終端」，或者使用快捷鍵 Ctrl+` (反引號)。
    2. 切換到文件所在目錄： 如果您的文件不在當前終端目錄，請使用 cd 命令切換到 hello.py 所在的文件夾。
    3. 執行命令： 在終端中輸入以下命令並按回車：

      python hello.py

      或者對於某些系統，可能是：

      python3 hello.py

無論哪種方式，您都應該在終端輸出中看到「Hello, VS Code Python!」。

第六步：管理 Python 虛擬環境（強烈推薦）

在 Python 開發中，使用虛擬環境是一個最佳實踐。它能讓您的項目依賴項相互隔離，避免不同項目間的庫版本衝突。

為什麼使用虛擬環境？

  • 依賴隔離： 每個項目可以擁有自己獨立的庫版本，互不干擾。
  • 環境純凈： 避免全局安裝大量不必要的庫。
  • 項目可移植性： 方便地共享 requirements.txt 文件，讓他人能夠輕鬆復現您的開發環境。

如何在 VS Code 中創建和管理虛擬環境

  1. 打開命令面板： Ctrl+Shift+P (Windows/Linux) / Cmd+Shift+P (macOS)。
  2. 創建虛擬環境： 輸入「Python: Create Environment」，選擇您偏好的環境類型（通常是 Venv 或 Conda，如果已安裝 Anaconda）。

    VS Code 會提示您選擇要使用的 Python 解釋器，然後會在您的項目文件夾中創建一個新的虛擬環境（通常是 .venv 或 venv 文件夾）。

  3. 選擇虛擬環境： 創建完成後，VS Code 通常會自動激活並選擇這個新創建的虛擬環境。如果沒有，可以再次使用「Python: Select Interpreter」命令，選擇您剛剛創建的虛擬環境（它會顯示在解釋器列表中）。
  4. 安裝依賴： 當虛擬環境激活后，在 VS Code 的內置終端中安裝項目所需的庫：

    pip install package_name

第七步：常見問題及解決方案

問題一：VS Code 找不到 Python 解釋器

描述： 在 VS Code 左下角狀態欄沒有顯示 Python 版本，或者嘗試運行 Python 文件時報錯「Python is not installed」。

解決方案：

  • 檢查 Python 安裝： 確保您已按照第二步正確安裝了 Python 解釋器，並且在命令行（非 VS Code 終端）中可以正常運行 python --version。
  • 檢查 PATH 環境變數：

    Windows： 確保在安裝 Python 時勾選了「Add Python to PATH」，或者手動將其添加到系統環境變數。
    macOS/Linux： 確保 Python 解釋器的路徑在您的 shell 配置文件（如 .bashrc, .zshrc）的 PATH 變數中。

  • 重新選擇解釋器： 在 VS Code 中使用 Ctrl+Shift+P -> 「Python: Select Interpreter」，手動瀏覽並選擇 Python 解釋器的完整路徑（例如 C:Python39python.exe 或 /usr/local/bin/python3）。
  • 重啟 VS Code： 有時重啟 VS Code 可以解決路徑未更新的問題。

問題二：Linter (Pylint/Flake8) 或 Formatter (Black/YAPF) 不工作

描述： VS Code 沒有提供代碼語法檢查或自動格式化功能。

解決方案：

  • 安裝對應的工具： 在已激活的虛擬環境或全局環境中安裝這些工具。例如：

    pip install pylint black flake8

  • 配置 VS Code： 在 VS Code 的設置中配置使用這些工具。

    打開設置（Ctrl+, 或 Cmd+,），搜索以下設置：

    • python.linting.pylintEnabled (設為 true)
    • python.formatting.provider (設為 "black" 或 "yapf")
    • 您也可以在工作區設置中為特定項目進行配置。
  • 重新載入窗口： 安裝或配置后，可能需要通過 Ctrl+Shift+P -> 「Developer: Reload Window」來刷新 VS Code。

問題三：調試器不啟動或無法命中斷點

描述： 嘗試使用 VS Code 的調試功能時遇到問題。

解決方案：

  • 檢查 Python 解釋器： 確保您選擇了正確的 Python 解釋器，並且它與您要調試的代碼兼容。
  • 安裝 debugpy： VS Code 的 Python 調試器依賴於 debugpy 庫。在您的環境中安裝它：

    pip install debugpy

  • 配置 launch.json： 對於更複雜的調試場景，您可能需要手動創建或編輯 .vscode/launch.json 文件，以正確配置調試器。

    點擊 VS Code 左側的「運行與調試」圖標，然後點擊「創建 launch.json 文件」鏈接，選擇「Python File」模板。

  • 檢查防火牆： 確保防火牆沒有阻止 VS Code 或 Python 進程的網路連接。

總結

通過遵循本指南中的詳細步驟，您應該已經成功在 VS Code 中安裝並配置了 Python 開發環境。從安裝 Python 解釋器到 VS Code 擴展，再到運行您的第一個程序和管理虛擬環境，我們提供了全面的指導。

VS Code 結合其強大的 Python 擴展，將極大地提升您的 Python 編程體驗。現在，您可以盡情探索其豐富的功能，如智能代碼補全、集成調試器、版本控制以及眾多實用的插件，讓您的開發工作更加高效和愉快。

祝您編碼愉快！

如發現政治性、事實性、技術性差錯和版權方面的問題及不良信息，請及時與我們聯繫。 365lvtu.com © 2019-2022. All Rights Reserved.