PyCharm 2025.3 Help

高级设置

除了您经常使用的标准设置之外，PyCharm 还提供多种高级选项，您可以用它们对特定产品功能的行为进行微调。

由于高级设置包含不同的部分，您可以使用搜索字段快速导航到感兴趣的部分或所需的选项。 您也可以搜索注册表键，因为某些高级选项具有相关的注册表键。

书签

项目

说明

仅在弹出窗口中显示行书签

默认情况下，PyCharm 仅在书签弹出窗口（Shift+F11 或 编辑 | 书签 | 显示行书签… ）中显示行书签。 如果您希望在该弹出窗口中查看其他书签项，例如文件或文件夹，请禁用此选项。 有关更多信息，请参阅 书签。

构建工具。 Gradle

项目

说明

下载源代码

默认情况下，PyCharm 在初始项目同步时不会为项目依赖项下载源代码。

选择此选项可更改项目行为，并在导入过程中始终为依赖项下载源代码。

数据库

项目

说明

如果由脚本化加载器检测到，则将文件作为表格打开

适用于受 脚本化数据加载器 支持的格式的文件。 定义 PyCharm 在表格视图中打开哪些文件。

  • 全部 ：所有受支持的表格数据文件。

  • 表优先格式 ：采用专门用于以表格格式表示数据的文件格式的文件。 当前为所有受支持的表格数据文件格式，除 JSON 外。

  • 无 ：对所有文件禁用该视图。

在随处搜索中显示数据库选项卡

在 随处搜索 中启用 数据库 选项卡（双击 Shift）。

有关在任意位置搜索功能的更多信息，请参阅 按名称搜索目标（随处搜索）。

调试器

项目

说明

最近表达式的最大数量

要在 计算表达式 历史记录中保存的表达式数量。

开发容器

项目

说明

使用 --depth=1 克隆源代码

使用此选项可通过检出源代码的最新版本来加快项目克隆过程。 有关更多信息，请参阅 Git 文档。

自动选择后端版本

选中此选项时，将自动选择 IDE 的最新版本。

如果部署开发容器后端/前端耗时超过 10 秒，则显示通知

选中此选项时，IDE 会显示通知。

重建 Docker Compose 开发容器时使用 '--no-recreate'。 Main 服务将始终重新创建。

选中此选项时，即使您使用 --no-recreate 选项来避免重建未更改的容器，也会重新创建主要开发容器。

Docker

项目

说明

重启时自动连接到Docker

在 PyCharm 启动后 连接到已配置的 Docker 守护进程。

镜像注册表实体加载限制

出于性能原因，默认情况下，PyCharm 只在 Docker 注册表 中显示前 100 个镜像。 如需列出更多，请增大该数字。 这也会增加内存使用量。

日志标签页应该是Docker 容器的第一个标签页。

将 日志 选项卡显示为 容器概览窗格 中的第一个选项卡。

用于自动重新连接的定期Docker 状态检查之间的延迟

PyCharm 检查与 Docker 连接状态的频率（毫秒）。

对 SELinux 系统的几乎所有绑定卷应用 :z 挂载选项

在 SELinux 工作站上，将 :z 配置标志添加到 Docker 绑定挂载，以在 将卷连接到 Docker 容器。

编辑器

使用此部分配置在 编辑器 中工作的其他选项。

项目

说明

在未选择任何内容的情况下调用“复制”或“剪切”操作时不复制/剪切当前行

此选项可覆盖在编辑器中未选择任何内容时复制 Ctrl+C 或剪切 Ctrl+X 整个当前行的 默认行为。

在未选择任何内容时调用复制操作后，不要选择已复制的行

默认情况下，在未选择任何内容时使用 Ctrl+C ，会复制整行。 使用此操作，您可以避免该选择。

粘贴在未选择任何内容时复制的行时

您可以更改 在插入符号所在行之上粘贴 的默认行为，并选择 在插入符号所在行粘贴 （恢复旧的复制/粘贴行为）或 若粘贴中间行，则修剪 （如果在行中间粘贴，将删除复制行前后的多余空格）。

使用其Unicode 名称缩写渲染特殊字符(例如控制代码)

选中此选项后，您可以对特殊字符（例如控制代码）使用 Unicode 名称缩写。

显示缩放指示器

在编辑器中 缩放 代码时，使用此选项可显示一个指示器，显示当前字体大小并提供恢复为默认值的选项。

制表符呈现

您可以从以下选项中进行选择：

  • 水平线

  • > 符号

  • 长箭头

免打扰模式下的左边距

此选项可让您在 免打扰模式和禅模式 下调整左侧编辑器边距。

默认情况下，这些查看模式中的编辑器文本垂直居中，文本列宽与 编辑器 | 代码样式 设置页面上的 强制换行列 选项相对应  Ctrl+Alt+S。 这意味着，您的代码在 正确格式化 时会居中，但如果存在较长且未换行的行，文本可能会超出视口，而左侧仍有较大的边距。 在这种情况下，您可能希望使用此选项减小左侧边距。

行号的字体增量

使用此选项可相对于编辑器中的字体大小，调整左侧装订区域中行号的字体大小。

对代码行长度超过此值的文档强制进行自动换行n 个字符

默认数值为 100000。 增大该数字可能会对编辑器性能产生负面影响。

使用 '扩展选择' 选择空白字符

使用此选项可在调用 扩展选择 操作时包含空白字符。

通过行注释操进行注释后，将文本光标下移

此选项允许您配置在使用 行注释注释一行 Ctrl+/ 时，是否将光标移动到下一行。 请注意，如果编辑器中存在选区，则无论此选项如何，光标都不会移动。

编辑器选项卡

除了 PyCharm 在编辑器中 使用选项卡 时提供的标准 编辑器选项卡选项 外，本节还包含一些额外选项，这些选项也可作为内部注册表操作使用。

项目

说明

导航到文件时，首选在停用拆分窗格中选择现有标签页

当您导航到在非活动拆分中已打开的文件时，使用此选项可在该拆分窗格中激活现有文件，而不是在活动拆分中打开该文件的新副本。

在同一个标签页中打开声明源

当您导航到方法、类或变量时，如果没有更改，包含其声明的源文件将替换当前选项卡。

在主IDE 窗口中打开从分离窗口调用的声明源

当您在分离窗口中导航到方法、类或变量时，PyCharm 会在主编辑器中打开包含该声明的源文件。

通过双击编辑器标签页执行“隐藏所有工具窗口”/“还原窗口”

启用此选项后，您可以双击编辑器选项卡以 隐藏并恢复所有工具窗口。 或者，您可以按 Ctrl+Shift+F12 ，或在主菜单中选择 窗口 | 活动工具窗口 | 隐藏所有窗口/恢复窗口。

通过双击编辑器标签页执行“最大化编辑器”/“标准化拆分”

启用此选项后，您可以在 拆分的编辑器选项卡组中双击选项卡以更改选项卡组的相对大小：第一次双击会将该选项卡及其所在组扩展到最大，并将其他所有组缩小到最小宽度/高度；第二次双击会为每个选项卡组分配相同的宽度和高度。

或者，您可以在主菜单中选择 窗口 | 编辑器选项卡 | 最大化编辑器/标准化拆分 ，或在 查找操作弹出窗口 Ctrl+Shift+A 中选择这些操作。

此选项可以与 通过双击编辑器标签页执行“隐藏所有工具窗口”/“还原窗口” 配合使用，但请注意，每次双击文件选项卡时，IDE 布局都会发生多次变化。

在嵌套拆分中均衡比例

使用此选项可使编辑器中多个水平或垂直拆分的大小均等。

将固定的标签页留在左侧

始终将 固定的选项卡移动到编辑器选项卡栏的左侧。 否则，固定的选项卡的位置不固定，您可以在选项卡栏上按需移动它们。

查找/替换

使用此部分配置在 在项目中查找并替换 中工作的额外选项。

项目

说明

在查找用法视图中启用相似用法聚类

PyCharm 会分析搜索结果，检测最常见的用法模式，并根据结构相似性将所有找到的用法进行分组。 这些用法聚类会显示在 预览 选项卡中。

在“在文件中查找/显示用法”预览中显示的最大结果数

默认最大结果数为 100。 增大此限制可能会显著增加内存使用量。

IDE

使用此部分配置存储项目不同实体的额外选项。

项目

说明

最近项目的最大数量

使用此选项可更改存储的最近项目的默认数量，默认为 50。

最近文件的最大数量

使用此选项可更改存储的 最近文件的默认数量，默认为 50。

最近位置的最大数量

使用此选项可更改存储的 最近位置的默认数量，默认为 25。

在本地历史记录中存储更改的持续时间

使用此选项指定要在 本地历史记录中保留更改的天数。

Kubernetes

项目

说明

如果没有可用集群，则显示空Kubernetes 节点

如果选中，当没有可用集群时，PyCharm 会在 服务 工具窗口中显示 Kubernetes 节点。

要加载的kubeconfig 文件的最大大小

指定 PyCharm 试图加载的 kubeconfig 文件的最大大小（以兆字节（MB）为单位）。

要加载的CRD YAML 文件的最大大小

指定 PyCharm 试图加载的资源 YAML 文件的最大大小（以兆字节（MB）为单位）。

kubectl 集群操作超时

指定 PyCharm 等待 kubectl 集群操作完成的超时时间（秒）。 如果操作时间更长，将因延迟或无响应而被取消。

HTTP 请求的超时时间

指定 PyCharm 等待发送到 Kubernetes 集群的 HTTP 请求的超时时间（秒）。 如果请求时间更长，将因延迟或无响应而被取消。

Markdown

项目

说明

隐藏浮动工具栏

当您在 Markdown 文件中选择某些文本时，PyCharm 会显示一个包含各种格式设置选项的 浮动工具栏。 如果您不想看到浮动工具栏，请选中此复选框，然后重新打开该选项卡以应用更改。

在标题锚点中将多个破折号替换为一个

将章节标题生成的锚点中的两个或更多连字符合并为一个。

项目视图

使用此部分配置在 项目工具窗口 中工作的其他选项。

项目

说明

按下Enter 键时将焦点移至编辑器

选中此选项后，您可以在 项目视图 中按 Enter 将焦点切换到编辑器。

收起节点时，也收起下面所有展开的节点

选中此选项时，PyCharm 会同时折叠子节点以及父节点。

导航到库类时，请勿在项目树中选择它

即使启用了 始终选择打开的文件 选项，也不要在 项目 工具窗口中自动导航到库文件。

您可以在工具窗口中手动导航到库文件：使用 项目 工具窗口工具栏上的 选择打开的文件 按钮，或按 Alt+F1 打开 选择位置 弹出窗口。

增大项目视图中的字号

如果您希望更改 项目 视图中的字体大小，请选择此选项。 您需要重启 PyCharm。

Rails

项目

说明

自动加载生成器

默认启用，使用此选项可自动加载 Rails 生成器。 禁用该选项时，您仍可手动触发该操作。

Rake

项目

说明

自动加载任务

默认启用，使用此选项可自动加载 Rake 任务。 禁用该选项时，您仍可手动触发该操作。

Python

项目

说明

在Pytest 中交换实际断言和预期断言的顺序

默认情况下，PyCharm 提供 expected == actual pytest 断言。 选中此复选框可将断言参数的顺序更改为 actual == expected。

Pytest: 不添加 "--no-header --no-summary -q"

使用此复选框管理由 pytest 生成的测试输出。 选中它以继续呈现标题和摘要。

运行/调试

项目

说明

临时配置限制

使用此选项可更改存储的临时 运行/调试配置的默认数量，默认为 5。

确认在进程终止时重新运行

当您对正在运行的进程调用重新运行时，PyCharm 会提示您确认终止现有进程并启动新进程的操作。 您可以通过清除此复选框来更改默认行为。

将配置设为默认固定

选择此选项可在运行配置后，自动固定在 运行 工具窗口中打开的选项卡。

新 UI 中最近运行配置的最大数量

指定将在 运行小部件 中显示的最近运行/调试配置的数量。

SSH

项目

说明

配置文件解析器

选择解析器：

  • 旧版 ：对 ~/.ssh/config 使用旧版解析器。

  • OpenSSH ：使用基于 ssh -G 的解析器。 您的计算机上必须安装 OpenSSH。

OpenSSH 工具的自定义路径

如果选择了 OpenSSH 解析器，请指定 OpenSSH 的路径。

在任意位置搜索

项目

说明

在随处搜索中显示文本搜索结果

在 随处搜索 中启用 文本搜索。 结果将显示在新的 文本 选项卡以及列表底部的 全部 选项卡上。

在显示结果之前等待所有提供程序完成

在显示最终搜索结果之前，等待所有搜索提供程序完成其工作。 此选项会固定搜索结果中条目的位置，防止其在列表中跳动。 如果存在较慢的搜索提供程序，此选项可能会降低在任意位置搜索的操作速度。

在 等待提供程序的超时（毫秒） 字段中，指定等待搜索提供程序完成其工作的时间。

在操作选项卡中基于机器学习对结果排序

默认情况下， 操作 选项卡上的搜索结果使用机器学习进行排序，而不是使用标准排名机制。

在文件选项卡中基于机器学习对结果排序

默认情况下， 文件 选项卡上的搜索结果使用机器学习进行排序，而不是使用标准排名机制。

在全部选项卡中基于机器学习对结果排序

使用机器学习而非标准排名机制对 全部 选项卡上的搜索结果进行排序。

在操作选项卡中启用语义搜索

如果您希望 PyCharm 在 操作 选项卡中使用语义搜索（一种分析搜索查询背后意图和上下文含义的技术），以提供更相关的结果，请选择此选项。

在文件选项卡中启用语义搜索

如果您希望 PyCharm 在 文件 选项卡中使用语义搜索（一种分析搜索查询背后意图和上下文含义的技术），以提供更相关的结果，请选择此选项。

在符号选项卡中启用语义搜索

如果您希望 PyCharm 在 符号 选项卡中使用语义搜索（一种分析搜索查询背后意图和上下文含义的技术），以提供更相关的结果，请选择此选项。

在类选项卡中启用语义搜索

如果您希望 PyCharm 在 类 选项卡中使用语义搜索（一种分析搜索查询背后意图和上下文含义的技术），以提供更相关的结果，请选择此选项。

在查找、替换、重命名中的搜索范围

项目

说明

保留上次选择的搜索范围

选择此选项以快速查找搜索范围的历史记录。

启动

项目

说明

如果项目启动时没有打开的文件，则打开README.md 文件

如果选择此选项，在您启动项目时没有打开的文件，PyCharm 将打开一个 README.md 文件。

终端

配置与 嵌入式终端模拟器 相关的高级设置。

项目

说明

终端回滚缓冲区大小

使用此选项可增大终端中的缓冲区大小。

使用Escape 将焦点移至编辑器

选中此选项后，您可以使用 Escape 将焦点从终端切换到编辑器。

键盘缓冲

在终端中启用预输入，对于存在输入延迟的远程连接很有用。

键盘缓冲延迟阈值

当终端延迟超过指定值（毫秒）时，启用预输入。

对备用屏幕缓冲区使用 1.0 行距

使用备用屏幕缓冲区的终端应用可能具有各自的视觉样式。 此设置会在终端的备用屏幕缓冲区模式下保持 1.0 的行距。

填充字符背景（包括行距）

如果备用屏幕缓冲区模式下的行距值超过 1.0，行间可能会出现白色水平空隙。 选中此复选框以填充这些空隙。

显示应用程序标题

根据您运行的命令自动命名终端选项卡。

终端字符编码

为终端指定编码。

测试索引任务

项目

说明

将测试索引显示为后台任务

您可以在 Progress bar 中像其他 后台任务 一样监控并暂停/取消测试索引。 此选项默认启用。

在指定的超时（毫秒）后，将测试索引显示为后台任务

此选项设置经过多长时间，测试索引会作为后台任务显示在 Progress bar 中。

工具窗口

项目

说明

始终显示工具窗口标题图标

默认情况下，只有当您将鼠标悬停在工具窗口上或工具窗口获得焦点时，工具窗口标题中的图标（例如， 隐藏 和 选项 ）才会显示。

启用该选项以始终显示工具窗口标题图标。

允许通过标题拖动工具窗口以移至另一位置

通过拖动标题来移动工具窗口。

当该选项被禁用时，您可以通过拖动工具窗口栏、使用 移至 上下文菜单选项，或使用位于 工具窗口选项菜单/选项 图标下的工具窗口设置来 移动工具窗口。

用户界面

项目

说明

在IDE 帧标头中显示文件类型图标

在 macOS 上，可以使用该图标将文件拖动到其他应用程序。

对macOS 键盘快捷键使用单词而不是符号

如果您希望快捷键以文字而非符号显示，请选择此选项。

在列表和树中循环滚动

在第一个元素上按向上键时选择最后一个元素，反之亦然。

将鼠标光标放在对话框中的默认按钮上

选中此选项时，在对话框中，鼠标指针会定位到默认按钮（通常为 确定）。

禁用双击修改键快捷键

您可以禁用需要按两次同一键的快捷键。 例如， Shift 或 Ctrl。

版本控制

项目

说明

作为编辑器标签页打开差异

选中此选项后，Diff 查看器将显示为编辑器选项卡。

在编辑器中打开文件时加载VCS 中的文件注解

选中此选项后，在编辑器中打开文件时，PyCharm 会加载注解。

高亮显示忽略的文件

选中此选项后，PyCharm 会显示来自 VCS 的忽略文件列表，并在编辑器中显示其状态。

启用“提交”工具窗口

当您选择此选项时，PyCharm 会在单独的工具窗口中显示 本地更改 和 搁置 选项卡。

切换提交控件

选中此选项后，提交执行后，PyCharm 会隐藏提交面板和复选框，您可以在 提交更改 对话框中切换它们。

选择包含要推送的新提交的所有仓库

选中此选项后，PyCharm 将默认选择所有要推送的提交。

版本控制。 Git

项目

说明

递归克隆项目中的子模块

选中此选项后，从 Git 检出期间，将使用 git clone --recurse-submodules ，以克隆包含所有可用子模块的主存储库。

从Git 读取时应用内容转换

选中此选项后，PyCharm 在从 Git 读取文件内容时，会对 git cat-file 命令使用 --filters 或 --textconv 标志。

使用安全强制推送

选中此选项后，从 IDE 调用强制推送时，PyCharm 会使用 --force-with-lease ，而不是仅使用 --force。

检查传入和传出提交

选中此选项后，PyCharm 会在 分支 弹出窗口中更新具有传入或传出提交的分支的信息。

不运行Git 提交挂钩

选择此选项以禁用在提交操作期间自动运行提交钩子。

最后修改日期： 2025年 12月 2日
启动任务工具窗口参考