分享方式:


在 Visual Studio 搜尋路徑中使用 Python 資料夾

在典型的 Python 程式中,PYTHONPATH 環境變數 (或 IRONPYTHONPATH 等) 會提供模組檔案的預設搜尋路徑。 from <name> import...import <name> 陳述式會指示 Python 搜尋符合指定 <name> 之檔案的特定位置。 會依下列順序搜尋位置:

  1. Python 的內建模組
  2. 包含目前正在執行之 Python 程式碼的資料夾
  3. 適用環境變數所定義的「模組搜尋路徑」(如需詳細資訊,請參閱核心 Python 文件中的模組搜尋路徑環境變數)。

即使針對整個系統設定了搜尋路徑環境變數,Visual Studio 也會將它忽略。 原因是,使用變數會產生無法輕易回答的問題,例如:

  • 引用的模組預期會安裝 Python 2.7、Python 3.6 還是其他版本?
  • 在搜尋路徑環境變數中找到的檔案是否應該覆寫標準程式庫模組?
  • 是否會預計並處理任何覆寫行為,或該動作是否為惡意?

為了協助開發人員,Visual Studio 提供了一個可同時在 Python 環境和專案中直接指定搜尋路徑的方法。 您在 Visual Studio 中執行或偵錯的程式碼,會從 PYTHONPATH 環境變數和其他對等的變數來接收搜尋路徑。 透過新增搜尋路徑,Visual Studio 便會檢查指定位置中的程式庫,並視需要為它們建置 IntelliSense 資料庫。 (在 Visual Studio 2017 15.5 版和更早版本中,視程式庫數目而定,建構資料庫可能需要一些時間)。

必要條件

  • Visual Studio。 若要安裝產品,請遵循安裝 Visual Studio 中的步驟。

  • 您想要新增至搜尋路徑的 Python 資料夾。

新增 Python 資料夾至搜尋路徑

請遵循下列步驟,將 Python 資料夾新增至 Visual Studio 搜尋路徑:

  1. 在 [方案總管] 中,展開您的 Python 專案節點,以滑鼠右鍵按一下 [搜尋路徑],然後選取 [將資料夾新增至搜尋路徑]

    顯示如何在方案總管中的 Python 專案的搜尋路徑上存取 [新增資料夾至搜尋路徑] 命令的螢幕擷取畫面。

  2. 在對話方塊中,瀏覽至您要新增至已識別搜尋路徑的資料夾位置。

  3. 選取資料夾,然後選擇 [選取資料夾]

資料夾新增至搜尋路徑之後,Visual Studio 會將這些路徑用於與專案關聯的任何環境。

注意

如果是 Python 3 環境,且您嘗試將搜尋路徑新增至 Python 2.7 模組,則可能會出現錯誤。

新增 zip 和 egg 檔案至搜尋路徑

您可以使用 [新增 Zip 封存至搜尋路徑] 選項,將具有 .zip.egg 副檔名的檔案新增至搜尋路徑。 與使用資料夾時相同,系統會掃描這些檔案的內容並提供給 IntelliSense 使用。