從 Visual Studio Code 遷移到 PyCharm - Python 開(kāi)發(fā)環(huán)境切換指南

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

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

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

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

配置 Python 解釋器

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

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

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

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

安裝所需包

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

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

導(dǎo)入運(yùn)行配置

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

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

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

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

用戶界面差異

沒(méi)有工作區(qū)

啟動(dòng) PyCharm 時(shí)，你會(huì)注意到它沒(méi)有工作區(qū)的概念。這意味著你一次只能處理一個(gè)項(xiàng)目。在 Visual Studio Code 中，通常有一組可能相互依賴的項(xiàng)目，而在 PyCharm 中，你有一個(gè)由一組模塊組成的單個(gè)項(xiàng)目。

如果你有多個(gè)不相關(guān)的項(xiàng)目，可以將它們?cè)趩为?dú)的窗口中打開(kāi)。

工具窗口

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

1. 項(xiàng)目工具窗口
2. 提交工具窗口
3. 運(yùn)行工具窗口
4. Python 控制臺(tái)工具窗口
5. 數(shù)據(jù)庫(kù)工具窗口

要打開(kāi)工具窗口，點(diǎn)擊對(duì)應(yīng)的工具窗口按鈕：

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

• 項(xiàng)目：Alt + 1
• 提交：Alt + 0
• 終端：Alt + F12

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

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

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

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

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

多個(gè)窗口

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

總是選擇打開(kāi)的文件

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

一般工作流差異

沒(méi)有“保存”按鈕

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

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

保存操作

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

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

提交時(shí)的操作

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

快捷鍵

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

注意

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

VSCode 鍵映射

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

查找操作

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