快速入门指南
PyCharm 是专为 Python 打造的集成开发环境（IDE），为 Python 开发者提供广泛的基本工具，并经过紧密集成，营造便捷的高效开发环境，适用于高效的 Python、 Web 和 数据科学 开发。
了解更多 PyCharm 的功能
此前，PyCharm 提供两个版本：社区版与专业版。
从 PyCharm 2025.1 起，PyCharm 社区版与专业版合并为单一的统一产品： PyCharm。 借此变更，所有用户无需在版本之间切换即可访问基本功能。
PyCharm 的核心功能（包括 Jupyter Notebook 支持）将免费提供，此外，还将提供 Pro 订阅以获取附加功能。
安装统一版 PyCharm 后，您将自动获得 30 天的 Pro 免费试用，从而可以完全访问 PyCharm 的高级功能。
试用结束后，您可以：
购买 Pro 订阅以继续使用高级功能。
继续免费使用 PyCharm 的核心功能。
如果您已在使用 PyCharm 专业版，您现有的许可证将继续授予对所有 Pro 功能的完整访问权限——无需进行任何更改。
有关详细信息，请参阅 统一版 PyCharm 概述。
支持的语言
要在 PyCharm 中开始使用 Python 进行开发，您需要根据平台从 python.org 下载并安装 Python。
PyCharm 支持以下 Python 版本：
Python 2： 版本 2.7
Python 3： 从 3.9 版本到 3.14 版本
此外，在 Pro 模式下，您可以开发 Django、Flask 和 Pyramid 应用程序。 此外，还全面支持 HTML（包括 HTML5）、CSS、JavaScript 和 XML：这些语言通过插件捆绑在 IDE 中，并默认为您启用。 其他语言和框架的支持也可通过插件添加（转到 或 （适用于 macOS 用户），以了解更多信息或在首次启动 IDE 时进行设置）。
支持的平台
PyCharm 是一款跨平台 IDE，可在 Windows、macOS 和 Linux 上运行。 查看系统要求：
要求 | 最低 | 推荐 |
|---|---|---|
内存 | 2 GB 可用内存 | 8 GB 系统总内存 |
CPU | 任何现代 CPU | 多核 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）（Settings | Editor | Live templates 或（如果您是 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 便会显示所有可用选项的列表。 然后，选择您需要的操作：
随处搜索
如果您大致知道要查找的内容，可以使用现有导航功能之一定位相应元素。 但如果您想在每个角落都进行查找，该怎么办？ 答案是使用 随处搜索！
要试用它，请点击窗口右上角的放大镜按钮，或使用 双击 Shift 调用（按两次 Shift）。
运行、调试与测试
现在，您已经玩转了代码并发现了可以实现的功能，是时候运行、调试并测试您的应用了。
运行
运行应用程序的最简单方法是在编辑器中右键点击，然后在上下文菜单中选择 ：
如果您的 Python 脚本包含 __main__ 子句，则可以在装订区域中点击 
按钮，然后选择所需的命令。
您可以在 运行 工具窗口中查看脚本的执行情况。
当您在 PyCharm 中执行运行、调试或测试操作时，您始终会基于现有的 运行/调试配置 启动一个进程，并使用其中的参数。
首次运行应用程序时，PyCharm 会自动创建 临时运行/调试配置。 您可以对其进行修改以指定或更改默认参数，并将其保存为永久的运行/调试配置。
请参阅 运行/调试配置 ，了解如何调整运行/调试配置。
调试
您的应用程序是否遇到运行时错误？ 要找出其原因，您需要进行一些调试。 PyCharm 在所有平台上均支持调试器。
调试 从放置断点开始，程序会在断点处暂停执行，以便您检查程序数据。 只需点击您希望出现断点的那一行的装订区域即可。
要开始调试您的应用程序，请按下 Shift+F9。 然后逐步执行程序（在 菜单或 调试工具窗口 中查看可用选项），求值任意表达式、添加监视，并为变量手动设置值。
有关详细信息，请参阅 调试。
测试
测试您的应用程序是个好主意，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 集成可用于编辑、执行和调试笔记本源代码，并检查执行输出，包括流数据、图像和其他媒体。
在 PyCharm 中安装 R 插件 后，您可以使用 R 语言 进行各种统计计算，并使用编码辅助、可视化调试、智能运行与预览工具及其他常用 IDE 功能。
正如您可能已经注意到的，创建各种类型的项目（例如 Django）需要数据源。 此外，您也很可能会将 SQL 语句注入到源代码中。
PyCharm Pro 不支持创建数据库，但提供管理和查询数据库的功能。 一旦您获得对某个数据库的访问权限，您便可以在 PyCharm 中配置一个或多个数据源，这些数据源反映数据库的结构，并存储数据库访问凭据。 基于这些信息，PyCharm 会与数据库建立连接，并提供检索或更改其中包含的信息的功能。
可通过 数据库工具窗口 （ ）访问数据库。 此工具窗口允许您处理数据库。 它允许您查看并修改数据库中的数据结构，并执行其他相关任务。
有关详细信息，请参阅 数据库工具与 SQL。
自定义您的环境
请随意 微调 IDE ，使其完美契合您的需求，并尽可能地提供帮助且使用舒适。 转到 设置 以查看可用的自定义选项列表。
外观
第一件要微调的事情是总体 "外观和体验"。转到 File | Settings | Appearance and Behavior | Appearance （ for macOS users）以选择 IDE 主题 ：浅色主题，或如果您更喜欢较暗的设置，则选择 Darcula。
编辑器
位于 File | Settings | Editor （ for macOS users）下的众多页面可帮助您调整编辑器行为的各个方面。 此处提供大量选项：从常规设置（例如启用 Drag'n'Drop、滚动配置等），到针对每种可用语言和使用场景的配色配置，再到选项卡与代码折叠设置、代码补全行为，甚至后缀模板。
有关详细信息，请参阅 配置 PyCharm 设置。
代码风格
可在 File | Settings | Editor | Code Style （ ，适用于 macOS 用户）下为每种语言定义 代码风格。 您也可以创建并保存您自己的代码风格方案。
有关详细信息，请参阅 配置代码样式 和 代码质量辅助的技巧与提示，或者如何让您的代码看起来更漂亮？。
键位图
PyCharm 采用以键盘为中心的方法，这意味着 IDE 中几乎所有可执行的操作都映射到键盘快捷键。
您使用的 一组键盘快捷键是您最个人化的习惯之一——您的手指 "记住" 某些按键组合，而改变这种习惯说起来容易，做起来难。 PyCharm 为您提供默认键位图（在主菜单中选择 ），让您的编码更加高效、便捷。 然而，您可以随时 change it going to File | Settings | Keymap （ for macOS users）。
还提供一些预定义的键位图（如 Emacs、Visual Studio、Eclipse、NetBeans 等），您也可以基于现有的键位图创建自己的键位图。
如果您在使用 vi/Vim 时效率最高，仿真模式将为您带来两全其美的体验。 在 IDE 中启用 IdeaVim 插件，并选择 vim 键位图。
有关详细信息，请参阅 配置键盘快捷键。
就是这样！ 尽情开始愉快地开发吧！
我们希望这份关于 PyCharm 重要功能的简要概览能帮助您快速入门。 有许多重要功能可以让开发者的工作更轻松、更有趣，并让源代码更整洁、更清晰。 现在就先迈出这几步，然后在您认为合适的时候再深入探索：
尽情享受 PyCharm！ 如有任何问题，请访问我们的 讨论论坛、 twitter 和 博客 ，在那里您可以获取新闻、更新以及实用的提示与技巧。 此外，也请随时将任何问题报告给我们的 支持团队 或 PyCharm 问题跟踪器。