快速入门指南
PyCharm 是一个专为 Python 开发者设计的集成开发环境 (IDE)，提供广泛的必备工具，紧密集成以创建一个便捷的环境，用于高效的 Python、 web 和 数据科学 开发。
详细了解 PyCharm 的功能
之前，PyCharm 提供两个版本：Community 和 Professional。
从 PyCharm 2025.1 开始，PyCharm Community 和 Professional 将合并为一个统一的产品： PyCharm。 通过此更改，所有用户都可以访问基本功能，无需在不同版本之间切换。
PyCharm 的核心功能（包括 Jupyter Notebook 支持）将免费提供，并且 Pro 订阅将提供额外功能。
安装统一版本的 PyCharm 后，系统会自动为您提供 30 天的 Pro 免费试用，让您可以完全访问 PyCharm 的高级功能。
试用期结束后，您可以选择：
获取 Pro 订阅以继续使用高级功能。
继续免费使用 PyCharm 的核心功能。
如果您已经在使用 PyCharm 专业版，您将通过现有许可证保留对所有专业功能的完全访问权限，无需进行任何更改。
欲了解更多信息，请参阅 统一的 PyCharm 概览。
支持的语言
要在 PyCharm 中开始使用 Python 进行开发，您需要根据平台从 python.org 下载并安装 Python。
PyCharm 支持以下版本的 Python：
Python 2： 版本 2.7
Python 3： 从 3.8 版本到 3.14 版本
此外，在 专业版模式下，可以开发 Django、Flask 和 Pyramid 应用程序。 此外，它完全支持 HTML（包括 HTML5）、CSS、JavaScript 和 XML：这些语言通过插件捆绑在 IDE 中，并默认为您启用。 其他语言和框架的支持也可以通过插件添加（macOS 用户请转到 或 了解更多信息或在首次启动 IDE 时进行设置）。
支持的平台
PyCharm 是一个跨平台的 IDE，可在 Windows、macOS 和 Linux 上运行。 检查系统要求：
要求 | 最低 | 推荐 |
|---|---|---|
内存 | 2 GB 可用内存 | 8 GB 系统总内存 |
处理器 | 任何现代处理器 | 多核 CPU。 PyCharm 支持多线程进行不同的操作和处理，使其能够使用更多的 CPU 核心时速度更快。 |
磁盘空间 | 3.5 GB | 至少有 5 GB 可用空间的 SSD 硬盘 |
显示器分辨率 | 1024×768 | 1920×1080 |
操作系统 | 以下产品的正式发布版本：
不支持预发布版本。 | 以下内容的最新版本：
|
您可以使用 Toolbox 或 独立安装 安装 PyCharm。 如果您需要安装 PyCharm 的帮助，请参阅安装说明： 安装 PyCharm
从 PyCharm 中的项目开始
您在 PyCharm 中所做的一切，都是在项目的上下文中完成的。 它是代码辅助、大规模重构、代码风格一致性等功能的基础。 您有多种选项可以在 IDE 中开始处理项目：
您还可以在不设置项目的情况下创建 Python 文件或 Jupyter notebook：
在 欢迎屏幕 上，点击 新建笔记本 以创建 Jupyter notebook，或点击 新建脚本 以创建 Python 文件。
新文件将被添加到自动创建的 PyCharmMiscProject 中，您可以直接编写和执行代码，无需额外步骤。
打开现有项目
首先， 打开 存储在您计算机上的一个现有项目。 您可以在欢迎屏幕上的最近项目列表中选择一个，或点击 打开：
否则，您可以为现有的源文件创建一个项目。 在 菜单中选择命令 打开 ，并指定源文件所在的目录。 PyCharm 将为您从源文件创建一个项目。 有关更多信息，请参阅 从现有源创建项目。
从版本控制中检出现有项目
您还可以 从 VCS 存储或存储库下载源代码。 在 欢迎屏幕 上，单击 从 VCS 获取 ，然后选择 Git (GitHub)、Mercurial、Subversion 或 Perforce（仅在 PyCharm Pro 中支持）。
然后，输入源代码的路径并将存储库克隆到本地主机：
有关更多信息，请参阅 版本控制。
创建新项目
要创建项目，请执行以下操作之一：
转到
在 欢迎屏幕 上，点击 新项目
在 PyCharm 中，您只能创建 Python 项目；而在 PyCharm Pro 中，您可以创建各种 Web 框架项目。
有关更多详细信息，请参阅 创建一个 Python 项目。
创建新项目时，您需要指定一个 Python 解释器来执行项目中的 Python 代码。 您的计算机上至少需要有一个可用的 Python 安装。
对于新项目，PyCharm 会创建一个独立的 虚拟环境： venv、 pipenv、 poetry 或 Conda。 在工作过程中，您可以更改它或创建新的解释器。 您还可以在 Python 软件包 工具窗口中快速预览为解释器安装的包并添加新包。
有关更多信息，请参阅 配置 Python 解释器。
浏览
首次启动 PyCharm，或没有打开任何项目时，您将看到 欢迎屏幕。 它为您提供了进入 IDE 的主要入口点： 创建或打开项目 、从版本控制中检出项目、 查看文档以及 配置 IDE。
打开项目时，您会看到主窗口分为几个逻辑区域。 让我们花点时间看看这里的关键 UI 元素：
窗口标题包含一组小部件，可快速访问最常用的操作：项目小部件、VCS 小部件和运行小部件。 它还允许您打开 Code With Me、 全局搜索和 设置。
项目工具窗口位于左侧，显示您的项目文件。
编辑器位于右侧，您在其中实际编写代码。 它有便于在打开的文件之间导航的标签。
当您右键点击界面元素或代码片段时， 上下文菜单会打开，并显示可用的操作。
导航栏允许您快速导航项目文件夹和文件。
边距 ，编辑器旁边的垂直条显示您设置的断点，并提供一种方便的方式来 导航代码层次结构，例如转到定义/声明。 它还显示行号和每行的 VCS 历史记录。
滚动条 ，位于编辑器的右侧。 PyCharm 通过运行 代码检查不断监控您的代码质量。 右上角的指示器显示整个文件的代码检查总体状态。
工具窗口是附加在工作区底部和侧面的专用窗口。 它们提供对典型任务的访问，例如项目管理、源代码搜索和导航、与版本控制系统的集成、运行、测试、调试等。
状态栏 显示项目和整个 IDE 的状态，并提供各种警告和信息消息，如文件编码、行分隔符、检查配置文件等。 它还提供对 Python 解释器设置的快速访问。
项目工具窗口位于左侧，显示您的项目文件。
编辑器位于右侧，您在其中实际编写代码。 它有便于在打开的文件之间导航的标签。
导航栏允许您快速导航项目文件夹和文件。
边距 ，编辑器旁边的垂直条显示您设置的断点，并提供一种方便的方式来 导航代码层次结构，例如转到定义/声明。 它还显示行号和每行的 VCS 历史记录。
滚动条 ，位于编辑器的右侧。 PyCharm 通过运行 代码检查不断监控您的代码质量。 右上角的指示器显示整个文件的代码检查总体状态。
工具窗口是附加在工作区底部和侧面的专用窗口。 它们提供对典型任务的访问，例如项目管理、源代码搜索和导航、与版本控制系统的集成、运行、测试、调试等。
状态栏指示您的项目和整个 IDE 的状态，并显示各种警告和信息消息，例如文件编码、行分隔符、检查配置文件等。 它还提供对 Python 解释器设置的快速访问。
此外，在 PyCharm 窗口的左下角的状态栏中，您会看到按钮 
或 
。 此按钮用于切换工具窗口栏的显示。 如果您将鼠标悬停在此按钮上，当前可用的工具窗口列表将显示出来。
代码智能辅助
当您创建了一个新项目或打开了一个现有项目时，就可以开始编写代码了。
创建一个 Python 文件
在 项目 工具窗口中，选择 项目根目录 （通常是项目树中的根节点），右键点击它，然后选择 。
从上下文菜单中选择选项 Python 文件 ，然后输入新文件名。
PyCharm 会创建一个新的 Python 文件并将其打开以供编辑。
PyCharm 处理例行工作，让您可以专注于重要的事情。 使用以下编码功能来创建无错误的应用程序，而无需浪费宝贵的时间。
代码补全
代码补全是一个极大的时间节省工具，无论您正在处理哪种类型的文件。
基本补全在您输入时工作，并立即完成任何名称。
智能类型匹配补全会分析您当前正在处理的上下文，并根据该分析提供更准确的建议。
意图操作
PyCharm 会关注您当前正在做的事情，并提供称为 意图操作的智能建议，以节省您的时间。 意图操作通过一个灯泡指示，允许您对 正确的代码应用自动更改（与代码检查提供的针对 可能不正确代码的快速修复相对）。 您是否忘记为构造函数添加一些参数和字段初始化器？ 使用 PyCharm 这不是问题。 点击灯泡（或按 Alt+Enter ），然后选择建议的选项之一：
可用意图操作的完整列表可以在 或 （适用于 macOS 用户）中找到。
保持代码整洁
PyCharm 会监控您的代码，并尝试保持其准确和整洁。 它会检测潜在的错误和问题，并为它们提供 快速修复建议。
每当 IDE 发现未使用的代码、无限循环以及许多其他可能需要您注意的内容时，您会看到一个灯泡。 点击它，或按 Alt+Enter 以应用修复。
可用 检查的完整列表可以在 （或适用于 macOS 用户的 ）下找到。 禁用其中一些，或启用其他的，并调整每个检查的严重性。 您决定是否应将其视为错误或只是警告。
生成一些代码
使用 PyCharm 提供的 代码生成选项 ，编写代码可以变得更加轻松和快捷。 菜单 Alt+Insert 将帮助您从用法中创建符号，并建议覆盖或实现某些函数：
使用实时模板（选择 或按 Ctrl+J ）来生成完整的代码结构。 您可以在 设置 对话框（Ctrl+Alt+S ）中探索可用的现成实时模板（设置 | 编辑器 | 实时模板 或 macOS 用户的 ）。
如果您发现缺少某些对您的开发特别重要的内容，可以使用您自己的模板扩展此模板集。 此外，考虑快速 包围您的代码以完成结构（选择 或按 Ctrl+Alt+T）。 例如，使用 if 语句：
找到您的路径
当您的项目很大，或者您需要处理其他人的代码时，能够快速找到您正在寻找的内容并深入代码是至关重要的。 这就是为什么 PyCharm 提供了一组 导航和 搜索功能，帮助您穿越任何代码，无论它有多复杂。
基本搜索
通过这些搜索功能，您可以在 当前打开的文件 Ctrl+F 或 整个项目 Ctrl+Shift+F 中查找和替换任何代码片段。
搜索用法
要查找特定符号的使用位置，PyCharm 提供通过 查找用法 Alt+F7 的全面搜索：
项目导航
仅通过查看文件结构及其导入或调用层次结构，您就可以了解很多信息：
此外，您可以导航到：
左侧边栏中的图标也可以帮助您进行导航：
通过时间线导航
记住您在项目中的所有活动，PyCharm 可以轻松导航到 最近的文件 Ctrl+E 或 最近更改的文件 Alt+Shift+C。
要查看更改历史，请使用以下操作：
后退(B) Ctrl+Alt+Left
前进(W) Ctrl+Alt+Right
最后编辑位置(O) Ctrl+Shift+Backspace
查找操作
利用 PyCharm 提供的许多智能操作。 例如，使用 查找操作搜索 Ctrl+Shift+A ：只需输入操作名称的一部分，IDE 就会显示所有可用选项的列表。 然后，选择您需要的操作：
Search Everywhere
如果您对要查找的内容有一个大致的想法，您可以始终使用现有的导航功能之一定位相应的元素。 但如果您想在每个角落和缝隙中寻找某些东西呢？ 答案是使用 全局搜索！
要尝试它，请点击窗口右上角的放大镜按钮，或通过 双击 Shift （按两次 Shift 键）调用它。
运行、调试和测试
现在，当您已经尝试了代码并发现可以用它做什么时，是时候运行、调试和测试您的应用程序了。
运行
运行应用程序的最简单方法是右键点击编辑器中的内容，然后从上下文菜单中选择 ：
如果您的 Python 脚本包含 __main__ 子句，那么您可以点击边栏中的 
按钮，然后选择所需的命令。
您可以在 运行 工具窗口中查看脚本的执行情况。
当您使用 PyCharm 执行运行、调试或测试操作时，您总是基于现有的 运行/调试配置及其参数启动一个进程。
当您第一次运行应用程序时，PyCharm 会自动创建 临时运行/调试配置。 您可以修改它以指定或更改默认参数，并将其保存为永久运行/调试配置。
请参阅 运行/调试配置 了解如何调整运行/调试配置。
调试
您的应用程序是否遇到了运行时错误？ 要找到问题的原因，您需要进行一些调试。 PyCharm 支持所有平台上的调试器。
调试 从设置断点开始，程序执行将在断点处暂停，方便您探索程序数据。 只需点击要设置断点的行的边栏。
要开始调试您的应用程序，请按 Shift+F9。 然后逐步执行程序（查看 菜单或 调试工具窗口 中的可用选项），评估任意表达式，添加监视，并手动设置变量的值。
如需了解更多信息，请参阅 Debugging。
测试
测试您的应用程序是个不错的主意，PyCharm 会尽可能简化这一过程。
使用 PyCharm ，您可以：
有关这些数字的更多信息，请参阅 测试运行器选项卡 部分。
PyCharm 支持所有主要的 Python 测试框架：
对于这些框架中的每一个，PyCharm 都提供自己的 运行/调试配置。
有关更多信息，请参阅 测试您的第一个 Python 应用程序 和 运行测试。
使用 PyCharm Pro ，您可以远程运行、调试和测试您的 Python 代码。 您可以将本地应用程序部署到一些远程服务器。 有关部署服务器的更多信息，请参阅 配置与 Web 服务器的同步部分。 PyCharm Pro 还可以帮助 比较本地和远程文件夹，并将本地副本与部署在服务器上的副本同步。
将您的源代码置于版本控制之下
VCS
如果您将源代码置于版本控制之下，您会很高兴知道 PyCharm 集成了许多流行的 版本控制系统 ：Git（或 GitHub）、Mercurial、Perforce（仅在 Pro 模式中支持）、Subversion。 要指定特定 VCS 的凭据和任何设置，请转到 （或对于 macOS 用户来说，转到 ）。
VCS 菜单为您提供有关可用命令的提示。 例如，您可以通过本地更改视图查看您所做的更改，提交它们，创建变更列表等操作： （或只需按 Alt+9）。
此外，您可以在主窗口中执行一些基本的 VCS 操作：
通过 VCS 小部件：
通过编辑器上方的导航栏：
有关更多信息，请参见 版本控制。
本地历史记录
除了传统的版本控制之外，您还可以使用 本地历史记录。 通过本地历史记录，PyCharm 会自动跟踪您对源代码的更改、重构的结果等。
本地历史记录始终处于启用状态。 要查看文件或文件夹的本地历史记录，请通过选择 本地历史记录来打开它： 。 在这里，您可以查看更改、撤销它们或创建补丁。
处理数据
PyCharm 提供一个交互式 Python 控制台，用于对数据执行智能操作，具有即查即用的语法检查、括号和引号匹配，当然还有代码补全。 您还可以受益于内置的 Anaconda 支持。
使用 PyCharm Pro ，您可以分析和可视化各种科学和统计数据。 Jupyter Notebook 集成使编辑、执行和调试 Notebook 源代码，以及检查执行输出成为可能，包括流数据、图像和其他媒体。
在 PyCharm 中安装 R 插件 后，您可以使用 R 语言 执行各种统计计算，并使用代码辅助、可视化调试、智能运行和预览工具以及其他流行的 IDE 功能。
您可能已经注意到，创建各种类型的项目（例如 Django）需要一个数据源。 也很可能您会将 SQL 语句注入到源代码中。
PyCharm Pro 不支持创建数据库，但提供了管理和查询数据库的功能。 一旦您获得对某个数据库的访问权限，您可以在 PyCharm 中配置一个或多个数据源，这些数据源反映数据库的结构并存储数据库访问凭据。 基于这些信息，PyCharm 建立与数据库的连接，并提供检索或更改其中包含的信息的能力。
数据库的访问由 数据库窗口 （ ）提供。 此工具窗口允许您处理数据库。 它使您能够查看和修改数据库中的数据结构，并执行其他相关任务。
有关更多信息，请参见 数据库工具和 SQL。
自定义您的环境
请随意 调整 IDE ，使其完全符合您的需求，并尽可能地高效和舒适。 转到 设置以查看可用的自定义选项列表。
外观
首先需要微调的是整体的“外观和感觉”。转到 文件 | 设置 | 外观和行为 | 外观 （ 适用于 macOS 用户）以选择 IDE 主题 ：如果您喜欢更暗的设置，可以选择浅色主题或 Darcula。
编辑器
在 文件 | 设置 | 编辑器 （ 适用于 macOS 用户）下提供的许多页面可以帮助您调整编辑器行为的各个方面。 这里有许多选项，从常规设置（如启用拖放、滚动配置等），到每种可用语言和用例的颜色配置，到选项卡和代码折叠设置，到代码补全行为，甚至后缀模板。
更多信息，请参见 配置 PyCharm 设置。
代码样式
代码样式可以在 文件 | 设置 | 编辑器 | 代码样式 （ 适用于 macOS 用户）下为每种语言定义。 您还可以创建并保存您自己的代码样式方案。
有关更多信息，请参阅 配置代码样式 和 代码质量辅助提示与技巧，或如何让您的代码看起来更漂亮？。
键位图
PyCharm 使用以键盘为中心的方法，这意味着 IDE 中几乎所有可能的操作都映射到键盘快捷键。
您使用的 键盘快捷键集是您最熟悉的习惯之一——您的手指“记住”了某些按键组合，而改变这种习惯并非易事。 PyCharm 为您提供了一个默认键位映射（从主菜单中选择 ），使您的编码真正高效且方便。 不过，您始终可以通过转到 更改它 ，路径为 文件 | 设置 | 键位映射 （ 适用于 macOS 用户）。
这里还有一些预定义的键位映射（如 Emacs、Visual Studio、Eclipse、NetBeans 等），您还可以基于现有的键位映射创建自己的键位映射。
如果您在 vi/Vim中感到最为高效，那么仿真模式将为您提供两全其美的体验。 在 IDE 中启用 IdeaVim 插件并选择 vim 键位映射。
欲了解更多信息，请参阅 配置键盘快捷键。
就是这样！ 继续愉快地开发吧！
我们希望这份关于 PyCharm 重要功能的简要概述能让您快速上手。 有许多重要功能可以让开发者的生活更轻松、更有趣，并使源代码更整洁、更清晰。 现在就采取这些第一步，然后在您觉得合适的时候深入挖掘：
享受 PyCharm 带来的乐趣！ 如果有任何问题，请访问我们的 讨论论坛、 twitter 和 博客 ，您可以在其中找到新闻、更新以及有用的提示和技巧。 此外，请随时将任何问题报告给我们的 支持团队或 PyCharm 的 问题跟踪器。