在 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 專案節點，以滑鼠右鍵按一下 [搜尋路徑]，然後選取 [將資料夾新增至搜尋路徑]：

   

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

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

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

注意

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

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

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

相關內容

• 在 Visual Studio 中管理 Python 環境
• 選取專案的解譯器
• 將 requirements.txt 用於相依項
• Python 環境視窗參考