這份指南是為使用 Visual Studio Code 的 Python 開發(fā)者準(zhǔn)備的，如果你打算切換到 PyCharm，這里包含了將 Visual Studio Code 項目導(dǎo)入到 PyCharm 的實際操作步驟，以及對兩個 IDE 最顯著差異的簡要解釋，包括用戶界面、一般工作流和快捷鍵。

將 Python 項目導(dǎo)入到 PyCharm

要將使用 Visual Studio Code 創(chuàng)建的 Python 項目導(dǎo)入到 PyCharm，只需在 PyCharm 中打開項目目錄：

1. 選擇以下任一操作：點擊 文件 -> 打開。在歡迎界面點擊 打開。
2. 在打開的對話框中，選擇包含所需源代碼的目錄。注意，外部創(chuàng)建的應(yīng)用程序會帶有常規(guī)目錄圖標(biāo) 。
3. 點擊 打開（在 Mac 上）或 確定（在 Windows 上）。
4. 如果你已經(jīng)打開了另一個項目，請指定是要在單獨的窗口中打開新項目，還是關(guān)閉當(dāng)前項目并使用現(xiàn)有窗口。

配置 Python 解釋器

PyCharm 會在源目錄中查找虛擬環(huán)境。如果檢測到，PyCharm 會建議使用它作為項目解釋器或配置新的解釋器。

如果沒有檢測到環(huán)境，PyCharm 會為項目設(shè)置系統(tǒng)解釋器。

有關(guān)配置其他類型 Python 解釋器的信息，請參考以下部分：

• 配置 pipenv 環(huán)境
• 配置 Poetry 環(huán)境
• 配置 conda 虛擬環(huán)境
• 使用 WSL 配置解釋器
• 使用 Vagrant 配置解釋器
• 使用 SSH 配置解釋器
• 使用 Docker 配置解釋器
• 使用 Docker Compose 配置解釋器

安裝所需包

如果導(dǎo)入的項目不包含虛擬環(huán)境，你可以配置新的 Python 解釋器，然后為它安裝所需的包：

• 對于 conda 和 virtualenv 環(huán)境，可以從 requirements.txt 安裝所需的包。你也可以使用 requirements.txt 創(chuàng)建 virtualenv 環(huán)境。
• 對于 pipenv 環(huán)境，在創(chuàng)建環(huán)境時啟用 從 Pipfile 安裝包 復(fù)選框，或者使用 Pipfile 創(chuàng)建環(huán)境。
• 對于 Poetry 環(huán)境，在創(chuàng)建環(huán)境時啟用 從 pyproject.toml 安裝包 復(fù)選框，或者使用 pyproject.toml 創(chuàng)建環(huán)境。

導(dǎo)入運行配置

目前，PyCharm 不支持從 launch.json 導(dǎo)入運行/調(diào)試配置。你需要為項目手動創(chuàng)建運行/調(diào)試配置：

1. 點擊 運行 -> 編輯配置。或者，點擊運行小部件中的 并從下拉菜單中選擇 編輯配置。
   
2. 在運行/調(diào)試配置對話框中，點擊工具欄上的 或按 Alt + Insert。列表顯示運行/調(diào)試配置模板。選擇 Python。
   
3. 根據(jù) launch.json 中的配置指定運行/調(diào)試配置參數(shù)。

以下是創(chuàng)建運行/調(diào)試配置時，如何將最常見的 launch.json 屬性轉(zhuǎn)換為參數(shù)：

• name：運行/調(diào)試配置的名稱。在 名稱 字段中指定。
• type：運行/調(diào)試配置的類型。在創(chuàng)建配置時選擇對應(yīng)的類型。
• request：指定是啟動程序的調(diào)試模式還是將調(diào)試器附加到已在運行的程序。對于 "request": "launch"，無需設(shè)置任何配置參數(shù)。如果配置中包含 "request": "attach"，則無法在 PyCharm 中創(chuàng)建類似的運行/調(diào)試配置。有關(guān)信息，請參考附加到進程。
• program：配置啟動時要運行的可執(zhí)行文件或文件。從下拉菜單中選擇要運行的目標(biāo)類型，然后指定要執(zhí)行的 Python 腳本路徑或模塊名稱。
• cwd：用于查找依賴項和其他文件的當(dāng)前工作目錄。在 工作目錄 字段中指定。
• args：運行或調(diào)試程序時傳遞給程序的參數(shù)。在 腳本參數(shù) 字段中指定。在此字段中，可以使用對應(yīng)于 Visual Studio Code 配置文件中變量的宏。有關(guān)信息，請參考傳遞參數(shù)給運行腳本。
• env：環(huán)境變量。在 環(huán)境變量 字段中指定。有關(guān)信息，請參考運行/調(diào)試配置。
• envFile：包含環(huán)境變量的 dotenv 文件路徑。在 .env 文件路徑 字段中指定文件路徑。有關(guān)信息，請參考運行/調(diào)試配置。
• console：用于運行或調(diào)試程序的控制臺。在 PyCharm 中，代碼通常在運行工具窗口中執(zhí)行。調(diào)試時，默認(rèn)會打開調(diào)試控制臺。不過，你可能需要指定其他執(zhí)行選項。有關(guān)信息，請參考運行/調(diào)試配置。
• justMyCode：當(dāng)省略或設(shè)置為 true 時，調(diào)試僅限于用戶編寫的代碼。在 PyCharm 中，可以通過在 設(shè)置 -> 構(gòu)建、執(zhí)行、部署 -> 調(diào)試器 -> 逐步執(zhí)行 中啟用或禁用 不要進入庫腳本 復(fù)選框來配置。有關(guān)信息，請參考逐步執(zhí)行。

用戶界面差異

沒有工作區(qū)

啟動 PyCharm 時，你會注意到它沒有工作區(qū)的概念。這意味著你一次只能處理一個項目。在 Visual Studio Code 中，通常有一組可能相互依賴的項目，而在 PyCharm 中，你有一個由一組模塊組成的單個項目。

如果你有多個不相關(guān)的項目，可以將它們在單獨的窗口中打開。

工具窗口

和 Visual Studio Code 一樣，PyCharm 也有工具窗口：

1. 項目工具窗口
2. 提交工具窗口
3. 運行工具窗口
4. Python 控制臺工具窗口
5. 數(shù)據(jù)庫工具窗口

要打開工具窗口，點擊對應(yīng)的工具窗口按鈕：

如果你不想使用鼠標(biāo)，可以按分配給它的快捷鍵切換到任何工具欄。最重要的快捷鍵要記住的是：

• 項目：Alt + 1
• 提交：Alt + 0
• 終端：Alt + F12

關(guān)于工具窗口的另一件事是，你可以拖動、固定、取消固定、附加和分離它們：

有關(guān)更多信息，請參考排列工具窗口和工具窗口視圖模式。

為了幫助存儲/恢復(fù)工具窗口布局，有幾個有用的命令：

• 窗口 -> 布局 -> 保存當(dāng)前布局為新布局：將排列保存為新布局。
• 窗口 -> 布局 -> 恢復(fù)當(dāng)前布局：重置當(dāng)前布局中的更改。（也可以通過 Shift + F12 使用）

有關(guān)更多信息，請參考布局。

多個窗口

PyCharm 中的窗口管理與 Visual Studio Code 稍有不同。你不能在一個項目中打開多個窗口，但可以將任意數(shù)量的編輯器選項卡分離到單獨的窗口中。要將選項卡移動到單獨的窗口，右鍵單擊選項卡并選擇將選項卡移動到新窗口（或按 Shift + F4）。

總是選擇打開的文件

默認(rèn)情況下，當(dāng)你在編輯器選項卡之間切換時，PyCharm 不會在項目工具窗口中導(dǎo)航到文件。不過，你可以在項目工具窗口設(shè)置中啟用此功能。

一般工作流差異

沒有“保存”按鈕

PyCharm 沒有保存按鈕。由于在 PyCharm 中可以撤銷重構(gòu)并從本地歷史記錄中恢復(fù)更改，因此每次都不需要詢問你保存更改。

盡管如此，要知道物理保存到磁盤是由某些事件觸發(fā)的，包括編譯、關(guān)閉文件、將焦點從 IDE 切換出去等。要更改自動保存行為，按 Ctrl + Alt + S 打開設(shè)置，然后導(dǎo)航到外觀和行為 -> 系統(tǒng)設(shè)置。在系統(tǒng)設(shè)置頁面，找到自動保存部分。

保存操作

如果你是 Visual Studio Code 的資深用戶，你熟悉保存操作：保存時自動觸發(fā)的操作，例如重新格式化代碼、整理導(dǎo)入等。

PyCharm 也有保存操作，你可以在設(shè)置 -> 工具 -> 保存時操作中找到并啟用。

提交時的操作

當(dāng)你提交更改時，可以自動運行各種操作。例如，你可以自動運行測試、重新格式化代碼、優(yōu)化導(dǎo)入等。

快捷鍵

下表顯示了頂級 Visual Studio Code 操作（及其快捷鍵）如何映射到 PyCharm（你可能需要打印出來以便隨時查看）。

注意

如果你選擇特定于操作系統(tǒng)的鍵映射（Windows/Linux 的默認(rèn)值或 macOS 的 macOS），可能會在 PyCharm 和操作系統(tǒng)之間出現(xiàn)快捷鍵沖突。為了避免此類沖突，建議調(diào)整操作系統(tǒng)的快捷鍵設(shè)置（參考鍵映射了解更多信息）。

VSCode 鍵映射

如果你不想學(xué)習(xí)新的快捷鍵，可以安裝 VSCode 鍵映射插件。它會為 PyCharm 添加 VSCode 鍵映射，與 Visual Studio Code 的快捷鍵非常相似。

查找操作

當(dāng)你不知道某個操作的快捷鍵時，嘗試使用通過 Ctrl + Shift + A 可用的查找操作功能。開始輸入以通過名稱查找操作，查看其快捷鍵或調(diào)用它。