一、簡介

PyCharm 是一款專為 Python 開發(fā)人員打造的集成開發(fā)環(huán)境（IDE），提供了豐富的工具，緊密集成，為高效的 Python、網絡和數(shù)據(jù)科學開發(fā)創(chuàng)造了一個便捷的環(huán)境。

二、選擇適合您的 PyCharm

PyCharm 提供兩個版本：

• 社區(qū)版（免費開源） ：適用于智能和智能的 Python 開發(fā)，包括編碼輔助、重構、可視化調試和版本控制集成。
• 專業(yè)版（付費） ：適用于專業(yè)的 Python、網絡和數(shù)據(jù)科學開發(fā)，除了社區(qū)版的功能外，還支持遠程配置、部署、流行網絡框架（如 Django 和 Flask）、數(shù)據(jù)庫支持、科學工具（包括 Jupyter 筆記本支持）和大數(shù)據(jù)工具。

三、支持的語言

要開始使用 PyCharm 進行 Python 開發(fā)，您需要根據(jù)您的平臺從 python.org 下載并安裝 Python。PyCharm 支持以下版本的 Python：

• Python 2: 版本 2.7
• Python 3: 從版本 3.6 到版本 3.13

此外，在專業(yè)版中，可以開發(fā) Django、Flask 和 Pyramid 應用程序。它還完全支持 HTML（包括 HTML5）、CSS、JavaScript 和 XML，這些語言通過插件捆綁在 IDE 中，默認為您啟用。您也可以通過插件添加對其他語言和框架的支持。

四、支持的平臺

PyCharm 是一款跨平臺的 IDE，適用于 Windows、macOS 和 Linux。安裝 PyCharm 可以使用 Toolbox 或獨立安裝。如果您需要安裝幫助，請參閱安裝說明。

五、從項目開始

在 PyCharm 中，您所做的一切都在項目的上下文中進行。它作為編碼輔助、批量重構、編碼風格一致性等的基礎。您有幾種選擇可以在 IDE 內開始項目：

• 打開現(xiàn)有項目
• 從版本控制中檢出項目
• 創(chuàng)建新項目

您也可以不設置項目就創(chuàng)建 Python 文件或 Jupyter 筆記本：

在歡迎屏幕上，如果您想創(chuàng)建 Jupyter 筆記本，點擊 “新建筆記本”；如果您想創(chuàng)建 Python 文件，點擊 “新建腳本”。新文件將被添加到自動創(chuàng)建的 PyCharmMiscProject 中，您可以無需額外步驟編寫和執(zhí)行代碼。

打開現(xiàn)有項目

首先，打開存儲在計算機上的現(xiàn)有項目之一。您可以在歡迎屏幕上的最近項目列表中選擇一個，或者點擊 “打開”：

否則，您可以為現(xiàn)有的源文件創(chuàng)建一個項目。在 “文件” 菜單中選擇 “打開” 命令，并指定源文件存在的目錄。PyCharm 將為您從源文件創(chuàng)建一個項目。有關詳細信息，請參閱從現(xiàn)有源文件創(chuàng)建項目。

從版本控制中檢出現(xiàn)有項目

您還可以從 VCS 存儲庫或存儲庫下載源代碼。在歡迎屏幕上，點擊 “從 VCS 獲取”，然后選擇 Git（GitHub）、Mercurial、Subversion 或 Perforce（僅在 PyCharm 專業(yè)版中支持）。

然后，輸入源代碼的路徑并將存儲庫克隆到本地主機：

創(chuàng)建新項目

要創(chuàng)建項目，可以執(zhí)行以下任一操作：

• 轉到 “文件” > “新建項目”
• 在歡迎屏幕上，點擊 “新建項目”

在 PyCharm 社區(qū)版中，您只能創(chuàng)建 Python 項目，而使用 PyCharm 專業(yè)版，您有多種選項來創(chuàng)建網絡框架項目。

社區(qū)版	專業(yè)版

當創(chuàng)建新項目時，您需要指定一個 Python 解釋器來執(zhí)行項目中的 Python 代碼。您需要在機器上至少有一個 Python 安裝可用。

對于新項目，PyCharm 會創(chuàng)建一個隔離的虛擬環(huán)境：venv、pipenv、poetry 或 Conda。在您工作時，您可以更改它或創(chuàng)建新的解釋器。您還可以在 Python 包工具窗口中快速預覽為您解釋器安裝的包并添加新包。

六、界面概覽

當您第一次啟動 PyCharm，或者沒有打開項目時，您會看到歡迎屏幕。它為您提供了進入 IDE 的主要入口：創(chuàng)建或打開項目、從版本控制中檢出項目、查看文檔以及配置 IDE。

當項目打開時，您會看到主窗口被分成幾個邏輯區(qū)域。讓我們花點時間來看看這里的關鍵 UI 元素：

新 UI	經典 UI

1. 窗口標題欄包含一組小部件，提供對最受歡迎操作的快速訪問：項目小部件、VCS 小部件和運行小部件。它還允許您打開 “與我一起編碼”、“隨處搜索” 和 “設置”。
2. 左側的項目工具窗口顯示您的項目文件。
3. 右側的編輯器是您實際編寫代碼的地方。它有標簽，便于在打開的文件之間導航。
4. 右鍵單擊界面元素或代碼片段時會打開上下文菜單，并顯示可用的操作。
5. 導航欄允許您快速導航項目文件夾和文件。
6. 編輯器旁邊的空白處顯示您設置的斷點，并提供了一種方便的方法來導航代碼層次結構，例如轉到定義 / 聲明。它還顯示行號和按行的 VCS 歷史記錄。
7. 編輯器右側的滾動條。PyCharm 不斷監(jiān)控您的代碼質量，通過運行代碼檢查來實現(xiàn)。右上角的指示器顯示整個文件的代碼檢查總體狀態(tài)。
8. 工具窗口是附加在工作區(qū)底部和側面的專用窗口。它們提供了對典型任務的訪問，例如項目管理、源代碼搜索和導航、版本控制系統(tǒng)的集成、運行、測試、調試等。
9. 狀態(tài)欄指示您的項目和整個 IDE 的狀態(tài)，并顯示各種警告和信息消息，例如文件編碼、行分隔符、檢查配置文件等。它還提供了對 Python 解釋器設置的快速訪問。

七、智能輔助編碼

當您創(chuàng)建了新項目或打開現(xiàn)有項目后，就可以開始編碼了。

創(chuàng)建 Python 文件

1. 在項目工具窗口中，選擇項目根（通常是項目樹的根節(jié)點），右鍵單擊它，然后選擇 “文件” > “新建”。
   
2. 從上下文菜單中選擇 “Python 文件”，然后輸入新文件名。
   

PyCharm 創(chuàng)建一個新的 Python 文件并打開它以供編輯。

PyCharm 處理日常事務，以便您可以專注于重要的事情。使用以下編碼功能來創(chuàng)建無錯誤的應用程序，而不會浪費寶貴的時間。

代碼補全

無論您處理何種類型的文件，代碼補全都是節(jié)省時間的好幫手。

基本補全在您輸入時工作，并立即完成任何名稱。

智能類型匹配補全分析您當前工作的上下文，并根據(jù)該分析提供更準確的建議。

意圖操作

PyCharm 會關注您當前正在做的事情，并提出稱為意圖操作的智能建議，以節(jié)省更多時間。意圖操作用燈泡表示，允許您對正確的代碼應用自動更改（與為可能不正確的代碼提供快速修復的代碼檢查不同）。您是否忘記在構造函數(shù)中添加一些參數(shù)和字段初始化器？有了 PyCharm，這不再是問題。點擊燈泡（或按 Alt + Enter），然后選擇其中一個建議的選項：

所有可用意圖操作的完整列表可以在 “文件” > “設置” > “編輯器” > “意圖操作”（對于 macOS 用戶，選擇 “PyCharm” > “設置” > “編輯器” > “意圖操作”）中找到。

保持代碼整潔

PyCharm 監(jiān)控您的代碼，并嘗試保持其準確性和整潔性。它會檢測潛在的錯誤和問題，并為這些問題建議快速修復。

每次 IDE 發(fā)現(xiàn)未使用的代碼、無限循環(huán)以及其他可能需要您注意的事情時，您都會看到一個燈泡。點擊它，或按 Alt + Enter，以應用修復。

所有可用檢查的完整列表可以在 “設置” > “編輯器” > “檢查操作”（對于 macOS 用戶，選擇 “PyCharm” > “設置” > “編輯器” > “檢查操作”）下找到。您可以禁用其中一些檢查，或啟用其他檢查，還可以調整每個檢查的嚴重性。您可以決定它是被視為錯誤還是只是警告。

生成代碼

使用 PyCharm 中可用的代碼生成選項，可以讓編寫代碼變得更加容易和快捷?！按a” > “生成” 菜單將幫助您從用法創(chuàng)建符號，以及建議覆蓋或實現(xiàn)某些函數(shù)：

使用實時模板（選擇 “代碼” > “插入實時模板” 或按 Ctrl + J）來生成整個代碼結構。您可以在設置對話框中（Ctrl + Alt + S）探索可用的現(xiàn)成實時模板（對于 macOS 用戶，選擇 “PyCharm” > “設置” > “編輯器” > “實時模板”）。

如果您發(fā)現(xiàn)缺少對您開發(fā)特別重要的某些內容，可以擴展這些模板集，添加您自己的模板。此外，考慮快速用完整的結構包圍您的代碼（選擇 “代碼” > “包圍” 或按 Ctrl + Alt + T。例如，用 if 語句：

八、找到您的方式

當您的項目很大，或者當您需要處理其他人的代碼時，能夠快速找到您需要的內容并深入代碼就顯得尤為重要。這就是 PyCharm 為什么配備了一套導航和搜索功能，幫助您在任何代碼中找到路徑，無論代碼多么復雜。

基本搜索

借助這些搜索功能，您可以使用?Ctrl+F?在當前打開的文件中，或在?Ctrl+Shift+F?整個項目中查找和替換代碼片段。

搜索用法

要查找某個符號在何處使用，PyCharm 建議通過 “查找用法” 進行全面搜索（快捷鍵：?Alt+F7?）。

項目導航

從文件結構中可以獲取很多信息，包括導入或調用層次結構：

此外，您可以導航到：

• 根據(jù)名稱導航到類、文件或符號。
• 導航到聲明（?Ctrl+B?）。
• 導航到基類 / 基函數(shù)（?Ctrl+U?）。

左側空白處的圖標也可以幫助您導航：

通過時間線導航

記住項目中的所有活動，PyCharm 可以輕松地將您導航到 “最近文件”（?Ctrl+E?） 或 “最近更改的文件”（?Alt+Shift+C?）。

要瀏覽歷史記錄，請使用以下操作：

• 后退（?Ctrl+Alt+←?）
• 前進（?Ctrl+Alt+→?）
• 最后編輯位置（?Ctrl+Shift+Backspace?）

查找操作

利用 PyCharm 提供的許多智能操作。例如，使用 “查找操作” （?Ctrl+Shift+A?）搜索：只需輸入操作名稱的一部分，IDE 將顯示所有可用選項的列表。然后，選擇您需要的操作：

全局搜索

如果您對要查找的內容有一個大致的概念，您可以使用現(xiàn)有的導航功能之一來定位相應的元素。但如果您想在每個角落和縫隙中查找，答案是使用全局搜索！

要嘗試它，點擊窗口右上角的放大鏡按鈕，或通過雙擊 Shift（按兩次 Shift）來調用它。

九、運行、調試和測試

現(xiàn)在，當您已經嘗試了代碼并發(fā)現(xiàn)了可以做的事情后，是時候運行、調試和測試您的應用程序了。

運行

運行應用程序最簡單的方法是右鍵單擊編輯器，然后從上下文菜單中選擇 “運行”。

如果您的 Python 腳本包含 ?__main__? 子句，那么您可以在空白處點擊按鈕，然后選擇所需的命令。

您可以在運行工具窗口中看到腳本的執(zhí)行情況。

當您在 PyCharm 中運行、調試或測試操作時，您總是基于現(xiàn)有的運行 / 調試配置之一啟動一個進程，使用其參數(shù)。

當您第一次運行應用程序時，PyCharm 會自動創(chuàng)建臨時的運行 / 調試配置。您可以修改它以指定或更改默認參數(shù)，并將其保存為永久的運行 / 調試配置。

有關如何調整運行 / 調試配置的詳細信息，請參閱運行 / 調試配置。

調試

您的應用程序是否在運行時遇到錯誤？要找出原因，您需要進行一些調試。PyCharm 在所有平臺上都支持調試器。

調試從在您希望暫停程序執(zhí)行的行處設置斷點開始。只需點擊您希望出現(xiàn)斷點的行的空白處即可。

要開始調試應用程序，請按 ?Shift + F9?。然后逐步瀏覽程序執(zhí)行（參閱 “運行” 菜單或 “調試” 工具窗口中的可用選項），評估任意表達式，添加監(jiān)視，并手動設置變量的值。

有關詳細信息，請參閱調試。

測試

測試您的應用程序是一個好主意，PyCharm 盡可能簡化了這一過程。

使用 PyCharm，您可以：

• 創(chuàng)建測試
• 創(chuàng)建專門的測試運行 / 調試配置。
• 直接從 IDE 中運行和調試測試，使用測試運行 / 調試配置。
• 最后但并非最不重要的一點是，您可以在運行工具窗口的測試運行程序選項卡中查看測試結果：
  

有關數(shù)字的詳細信息，請參閱測試運行程序選項卡部分。

PyCharm 支持所有主要的 Python 測試框架：

• Unittest
• Doctest
• Nosetest
• pytest

對于這些框架中的每一個，PyCharm 都提供自己的運行 / 調試配置。

有關詳細信息，請參閱測試您的第一個 Python 應用程序和運行測試。

使用 PyCharm 專業(yè)版，您可以遠程運行、調試和測試 Python 代碼。您可以將本地應用程序部署到遠程服務器。有關部署服務器的詳細信息，請參閱配置與 Web 服務器的同步。PyCharm 專業(yè)版還幫助比較本地和遠程文件夾，并將本地副本與服務器上部署的副本進行同步。

十、將源代碼置于版本控制之下

版本控制

如果您將源代碼置于版本控制之下，您會很高興知道 PyCharm 與許多流行的版本控制系統(tǒng)集成：Git（或 GitHub）、Mercurial、Perforce（僅專業(yè)版支持）、Subversion。要指定憑據(jù)和特定于特定 VCS 的設置，請轉到 “設置” > “版本控制”（對于 macOS 用戶，選擇 “PyCharm” > “設置” > “版本控制”）。

VCS 菜單為您提供了可用命令的線索。例如，您可以查看所做的更改，提交它們，創(chuàng)建更改列表等，從本地更改視圖：VCS > 顯示更改（或只需按? Alt + 9?）。

此外，您可以在主窗口中執(zhí)行一些基本的 VCS 操作：

從 VCS 小部件：

新 UI	經典 UI
從 VCS 小部件中：	從編輯器上方的導航欄：

有關詳細信息，請參閱版本控制。

本地歷史記錄

除了傳統(tǒng)的版本控制之外，您還可以使用本地歷史記錄。通過本地歷史記錄，PyCharm 自動跟蹤您對源代碼所做的更改，重構的結果等。

本地歷史記錄始終處于啟用狀態(tài)。要查看文件或文件夾的本地歷史記錄，請通過選擇 VCS > 本地歷史記錄 > 顯示歷史記錄來調用本地歷史記錄。在這里，您可以查看更改，回滾它們，或創(chuàng)建補丁。

十一、處理數(shù)據(jù)

PyCharm 擁有一個交互式的 Python 控制臺，可以在數(shù)據(jù)上執(zhí)行智能操作，具有實時語法檢查、檢查、括號和引號匹配以及當然還有代碼補全功能。您還可以受益于對 Anaconda 的內置支持。

使用 PyCharm 專業(yè)版，您可以分析和可視化各種科學和統(tǒng)計數(shù)據(jù)。Jupyter Notebook 集成允許編輯、執(zhí)行和調試筆記本源代碼并查看執(zhí)行輸出，包括流數(shù)據(jù)、圖像和其他媒體。

在 PyCharm 中安裝 R 插件后，您可以使用 R 語言進行各種統(tǒng)計計算，并使用編碼輔助、可視化調試、智能運行和預覽工具以及其他流行的 IDE 功能。

如您已經注意到的，創(chuàng)建各種類型（例如 Django）的項目需要數(shù)據(jù)源。您也可能在源代碼中注入 SQL 語句。

PyCharm 專業(yè)版雖然不能創(chuàng)建數(shù)據(jù)庫，但提供了管理數(shù)據(jù)庫和查詢數(shù)據(jù)庫的工具。一旦您獲得對某個數(shù)據(jù)庫的訪問權限，您可以在 PyCharm 中配置一個或多個數(shù)據(jù)源，以反映數(shù)據(jù)庫的結構并存儲數(shù)據(jù)庫訪問憑據(jù)?；谶@些信息，PyCharm 建立與數(shù)據(jù)庫的連接，并提供檢索或更改其中包含的信息的能力。

通過數(shù)據(jù)庫窗口（視圖 > 工具窗口 > 數(shù)據(jù)庫）訪問數(shù)據(jù)庫。此工具窗口允許您操作數(shù)據(jù)庫。它允許您查看和修改數(shù)據(jù)庫中的數(shù)據(jù)結構，并執(zhí)行與之相關的其他任務。

有關詳細信息，請參閱數(shù)據(jù)庫工具和 SQL。

十二、自定義您的環(huán)境

請隨意調整 IDE，使其完全符合您的需求，并盡可能地提供幫助和舒適。轉到設置以查看可用的自定義選項列表。

外觀

首先要微調的是總體的 “外觀和感覺”。轉到文件 > 設置 > 外觀和行為 > 外觀（對于 macOS 用戶，選擇 PyCharm > 設置 > 外觀和行為 > 外觀）以選擇 IDE 主題：淺色主題或 Darcula，如果您更喜歡較暗的設置。

編輯器

在文件 > 設置 > 編輯器下有許多頁面（對于 macOS 用戶，選擇 PyCharm > 設置 > 編輯器），可幫助您調整編輯器行為的每個方面。這里有很多可用選項，從常規(guī)設置（如啟用拖放、滾動配置等），到每種可用語言和使用情況的顏色配置，再到標簽和代碼折疊設置，以及代碼補全行為，甚至后綴模板。

有關詳細信息，請參閱配置 PyCharm 設置。

代碼風格

可以為每種語言定義代碼風格，在文件 > 設置 > 編輯器 > 代碼風格下（對于 macOS 用戶，選擇 PyCharm > 設置 > 編輯器 > 代碼風格）。您還可以創(chuàng)建并保存自己的編碼風格方案。

有關詳細信息，請參閱配置代碼風格和代碼質量輔助提示與技巧，或如何讓代碼更美觀。

鍵盤映射

PyCharm 采用以鍵盤為中心的方法，意味著在 IDE 中幾乎所有的操作都映射到鍵盤快捷鍵。

您習慣使用的一組鍵盤快捷鍵是您最親密的習慣之一 —— 您的手指 “記住” 了某些鍵的組合，改變這個習慣說起來容易做起來難。PyCharm 為您提供了默認的鍵盤映射（選擇幫助 > 鍵盤快捷鍵 PDF 從主菜單），讓您的編碼真正高效和方便。但是，您總是可以轉到文件 > 設置 > 鍵盤映射（對于 macOS 用戶，選擇 PyCharm > 設置 > 鍵盤映射）來更改它。

還有一些預定義的鍵盤映射（如 Emacs、Visual Studio、Eclipse、NetBeans 等），您也可以基于現(xiàn)有的鍵盤映射創(chuàng)建自己的鍵盤映射。

如果您使用 vi/Vim 最高效，仿真模式將為您帶來兩全其美的體驗。在 IDE 中啟用 IdeaVim 插件并選擇 vim 鍵盤映射。

有關詳細信息，請參閱配置鍵盤快捷鍵。

十三、開始愉快地開發(fā)吧

希望這份 PyCharm 必備功能的簡要概述能幫助您快速上手。有許多重要的功能可以讓開發(fā)人員的生活更輕松、更有趣，并且讓源代碼更整潔?，F(xiàn)在就邁出第一步，然后在您覺得合適的時候再深入研究：

• 創(chuàng)建并運行您的第一個項目
• 調試您的第一個 Python 應用程序
• 測試您的第一個 Python 應用程序
• 創(chuàng)建并運行您的第一個 Django 項目

享受 PyCharm 吧！如有任何問題，請訪問我們的討論論壇、推特和博客，在那里您可以找到新聞、更新和有用的提示與技巧。另外，如果遇到任何問題，不要猶豫向我們的支持團隊或 PyCharm 問題跟蹤器報告。