PyCharm 2025.3 Help

处理源代码

在处理代码时,PyCharm 可确保您的工作轻松无忧。 它提供多种快捷键和功能,帮助您添加、选择、复制、移动、编辑、折叠、查找出现位置并保存代码。

有关在编辑器中的导航,请参阅 编辑器基础

查找操作

  • 如果您不记得要使用的操作的快捷键,请按 Ctrl+Shift+A ,按名称查找任意操作。

您可以在同一对话框中查找类、文件或符号。 有关更多信息,请参阅 按名称搜索目标(随处搜索)

切换文件的只读属性

如果文件为只读,则会在 状态栏 、其编辑器选项卡或 项目工具窗口 中显示关闭的锁图标 锁定图标。 如果文件可写,则会在状态栏显示打开的锁图标 解锁图标

  1. 在编辑器中打开该文件,或在 项目 工具窗口中选择它。

  2. 执行以下任一操作:

    • 转到 文件 | 文件属性 | 将文件设为只读文件 | 文件属性 | 将文件设为可写

    • 点击 状态栏中的锁图标。

如果只读状态由版本控制系统设置,建议使用 PyCharm 的版本控制集成功能。 有关更多信息,请参阅 版本控制

交换字符

  1. 在编辑器中,将插入符号置于您要交换的字符处。

  2. 转到 编辑 | 转置

    此操作没有默认快捷键。 您可以分配一个 自定义快捷键

代码行

PyCharm 提供了多个用于操作代码行的实用快捷键。

  • 要在当前行之后添加一行,请按 Shift+Enter。 PyCharm 会将插入符号移动到下一行。

  • 要在当前行之前添加一行,请按 Ctrl+Alt+Enter。 PyCharm 会将插入符号移动到上一行。

  • 要复制一行,请按 Ctrl+D

  • 要按字母顺序对整个文件或代码选区中的行进行排序,请转到 编辑 | 排序行编辑 | 反转行。 在处理属性文件、数据集、文本文件、日志文件等时,这些操作可能很有用。 如果需要为这些操作分配快捷键,请参阅 配置键盘快捷键 了解更多信息。

  • 要删除一行,请将插入符号置于所需行并按 Ctrl+Y

  • 要合并行,请将插入符号置于要与其他行合并的那一行,并按 Ctrl+Shift+J。 持续按下这些键,直到所有需要的元素都已合并。

    您还可以合并字符串字面量、字段或变量声明以及语句。 请注意,PyCharm 会检查代码风格设置,并消除多余的空格和冗余字符。

  • 要将字符串字面量拆分为两部分,请按 Enter

    PyCharm 会拆分该字符串并提供正确的语法。 您也可以使用 在 '\n' 处断开字符串 意图操作来拆分字符串字面量。 按 Alt+Enter 或点击 意图操作按钮 以选择此意图操作。

  • 要注释一行代码,请将插入符号置于相应行并按 Ctrl+/。 在同一行再次按 Ctrl+/ 以取消注释。

  • 要上移或下移一行,请分别按 Alt+Shift+UpAlt+Shift+Down

  • 要将代码元素左移或右移(交换),将插入符号置于其上或选中它,然后按 Ctrl+Alt+Shift+Left 左移,或按 Ctrl+Alt+Shift+Right 右移。

复制并粘贴代码

您可以使用标准快捷键复制 Ctrl+C 并粘贴 Ctrl+V 任意选中的代码片段。 如果未选择任何内容,PyCharm 会原样复制插入符号所在的整行。

默认情况下,在编辑器中粘贴任何内容时,PyCharm 会执行 "智能" 粘贴。例如,在注释中粘贴多行时,会自动为您粘贴的行添加相应的标记。 如果您只需粘贴纯文本,请按 Ctrl+Alt+Shift+V

  • 在未选择任何代码的情况下复制(Ctrl+C )或剪切(Ctrl+X )一行时,粘贴操作会将剪贴板的内容添加到当前行上方,而不是在您的插入符号处。

    如果您希望在插入符号处粘贴已复制的代码,请在 高级设置 中选择 在插入符号位置粘贴 选项。

  • 将插入符号置于某一行或符号处,右键点击以打开上下文菜单,选择 复制/粘贴特殊 | 复制引用。 选择 复制引用Ctrl+Alt+Shift+C )选项后,PyCharm 会创建一个引用字符串,其中包含所选行或符号的行号。 您可以按 Ctrl+V 在任意位置粘贴复制的引用。

  • PyCharm 会记录您复制到剪贴板的全部内容。 要从历史记录粘贴,请在编辑器中的上下文菜单中选择 复制/粘贴特殊 | 从历史记录粘贴Ctrl+Shift+V)。 在打开的对话框中,选择您的条目并点击 粘贴

  • 当您将代码复制并粘贴到编辑器时,PyCharm 会显示以其 Unicode 名称缩写表示的隐藏(特殊)字符。

  • 您可以复制某一行或符号的引用。

    将插入符号置于某一行代码处并按 Ctrl+Alt+Shift+C (或从上下文菜单或 编辑 菜单中选择 复制引用)。 PyCharm 会根据插入符号处的符号创建相应格式的字符串。 例如:

    Solver.Solver.discr (用于 Python 方法)

    Solver\Solver.py:14 (用于 Python 文件)

选择代码

选择代码结构

  • 在编辑器中,将插入符号置于要选择的项上,然后按 Ctrl+W/Ctrl+Shift+W 以扩展或缩小选区。

    例如,在纯文本文件中,选区从整个单词开始,然后扩展到句子、段落等。

  • 如果您需要高亮显示括号,请将插入符号放在块的闭合大括号/中括号之后,或块的起始大括号/中括号之前。

根据大小写选择代码

  1. 设置 对话框(Ctrl+Alt+S )中,转到 编辑器 | 常规 | 智能键

  2. 选中 使用"CamelHumps" 单词 复选框。

如果您希望根据大小写通过双击选择单词,请确保下方的 在通过双击进行选择时允许"CamelHumps" 单词 复选框也已选中。

代码语句

移动语句

  • 在编辑器中,将插入符号置于所需语句处,按 Ctrl+Shift+Up 以上移语句,或按 Ctrl+Shift+Down 以下移语句。 PyCharm 会在执行语法检查的同时移动所选语句。

完成当前语句

  • 在编辑器中,按 Ctrl+Shift+Enter ,或在主菜单中选择 代码 | 完成当前语句。 PyCharm 会在结构体、切片和其他复合字面量中自动插入所需的结尾逗号。 插入符号将移动到您可以开始键入下一条语句的位置。

解包或移除语句

  1. 将插入符号置于您要移除或解包的表达式处。

  2. Ctrl+Shift+Delete ,或在主菜单中选择 代码 | 解包/移除

    PyCharm 会显示一个包含当前上下文所有可用操作的弹出窗口。 为了更容易区分将被提取的语句和将被移除的语句,PyCharm 使用不同的背景颜色。

    选择要解包的语句
  3. 选择一项操作并按 Enter

代码片段

  • 在编辑器中通过拖动来移动和复制代码片段。

    • 要移动代码片段,选择它并将选区拖动到目标位置。

    • 要复制代码选区,按住 Ctrl 不放,将其拖动到目标位置。

    拖动功能默认启用。 要将其禁用,请在 设置 对话框(Ctrl+Alt+S )中,转到 编辑器 | 常规 ,并在 鼠标控制 部分中清除 通过拖放移动代码片段 复选框。

  • 要在选定的代码片段中切换大小写,请按 Ctrl+Shift+U

    请注意,当您对 CamelCase 名称格式应用切换大小写操作时,PyCharm 会将该名称转换为小写。

  • 要注释或取消注释代码片段,选中它并按 Ctrl+Shift+/

    要配置注释行为的设置,请在位于 文件 | 设置 | 编辑器 | 代码样式 下特定语言页面的 代码生成 选项卡中,使用 注释代码 部分中的选项。

参数提示

参数提示 会显示方法和函数中的参数名,使您的代码更易读。 默认情况下,参数提示处于启用状态,并且仅对字面量或函数表达式等值显示,而不对命名对象显示。

配置参数提示

  1. 打开 设置 对话框(Ctrl+Alt+S ),并转到 编辑器 | 内联提示

  2. 展开 参数名称 下的 <所需语言>

  3. 通过选中相应的复选框,指定要显示参数提示的上下文。

    预览会显示您在设置中所做的更改如何影响代码外观。

  4. 对于某些方法和函数,PyCharm 在任何上下文中都不显示参数提示。 点击 排除列表... 以查看这些方法和函数,必要时为其启用参数提示,或向列表添加新项。

代码折叠

PyCharm 会自动识别某些代码结构并使其可折叠。 您也可以定义自定义折叠区域。

折叠的代码片段显示为带阴影的省略号(折叠的片段)。 如果折叠的代码片段存在错误,PyCharm 会以红色高亮显示该片段。

默认情况下,装订区域中的折叠图标会在悬停时显示。 您可以在 设置 | 编辑器 | 常规 | 代码折叠 中更改此行为并配置其他代码折叠设置。 例如,您可以禁用对单行 Rust 方法的默认折叠:

在主菜单(Ctrl+Shift+A )中转到 帮助 | 查找操作 ,并搜索 folding。 PyCharm 将显示一个包含所有折叠操作及其快捷键的弹出窗口:

展开或折叠代码元素

  • 要折叠或展开代码片段,请按 Ctrl+NumPad -/Ctrl+NumPad +。 PyCharm 会折叠或展开当前代码片段,例如单个方法。

  • 要折叠或展开所有代码片段,请按 Ctrl+Shift+NumPad -/Ctrl+Shift+NumPad +

    PyCharm 会折叠或展开选区内的所有片段;如果未选择任何内容,则会折叠或展开当前文件中的所有片段,例如文件中的所有方法。

  • 要递归地折叠或展开代码,请按 Ctrl+Alt+NumPad -/Ctrl+Alt+NumPad +。 PyCharm 会折叠或展开当前片段及其内部的所有从属区域。

  • 要折叠代码块,选择一个代码片段并按 Ctrl+Alt+T ,然后在弹出菜单中选择 region…endregion 注释。 使用 Ctrl+Alt+. 导航到自定义折叠块。

  • 要折叠或展开当前文件中的文档注释,请在主菜单中选择 代码 | 折叠 | 展开文档注释折叠文档注释

  • 要折叠或展开自定义代码片段,选择它并按 Ctrl+.。 或者,将该代码片段标记为 自定义折叠区域

    您可以折叠或展开代码中任意手动选择的区域。

折叠或展开嵌套片段

  • 要展开当前片段及其所有嵌套片段,请按 Ctrl+NumPad *, 1。 您可以将当前片段展开到指定的嵌套级别(从 1 到 5)。

  • 要展开文件中所有已折叠的片段,请按 Ctrl+Shift+NumPad *, 1。 您可以将已折叠的片段展开到指定的嵌套级别(从 1 到 5)。

自定义折叠区域

您可以使用专用注释将任意代码片段标记为 自定义折叠区域 ,从而使其可折叠。 之后,您可以使用 Ctrl+. 展开和折叠该片段,或在打开文件时让它自动折叠。

  1. 在编辑器中,选择一个代码片段并按 Ctrl+Alt+T

  2. 在弹出菜单中,选择 注释region…endregion 注释

  3. 可选地,指定一个描述,折叠后的片段将隐藏在该描述下。

  4. 要折叠或展开已创建的区域,请按 Ctrl+.

  5. 要导航到已创建的自定义折叠区域,请按 Ctrl+Alt+.

配置代码折叠图标

您可以选择如何显示出现在装订区域中的折叠图标,或完全禁用它们。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 常规 | 代码折叠

  2. 显示代码折叠箭头 列表中,选择 始终鼠标悬停时

    清除复选框以禁用图标。

最后修改日期: 2025年 12月 2日