PyCharm 2025.3 Help

辅助功能

PyCharm 使您可以启用多种辅助功能,以满足您的需求。 您可以使用屏幕阅读器,或调整字体大小、颜色以及某些 UI 元素的行为,以便更轻松地使用 PyCharm。

设置屏幕阅读器

PyCharm 在 Windows 和 macOS 上均完全支持屏幕阅读器。

启用屏幕阅读器

  1. 下载并启用您偏好的屏幕阅读器:

    • NVDA :请使用 NVDA 2019.3 或更高版本,以兼容 64 位 Java 应用(例如 PyCharm)。

      下载、安装并启用 NVDA。

    • JAWS :请使用 JAWS 12.0.1158 64 位或更高版本,以兼容 64 位 Java 应用(例如 PyCharm)。

      下载所需版本并重启计算机以启用 JAWS 屏幕阅读器。

    启用 VoiceOver 屏幕阅读器,因为它已内置于系统中。

  2. 请确保已安装 Java Access Bridge 以及与您的屏幕阅读器匹配的 Java 版本,具体如下:

    • 要启用 Java Access Bridge ,请打开命令提示符并键入 [JRE_HOME]\bin\jabswitch -enable ,其中 [JRE_HOME] 是您计算机上的 JRE 目录。 对于 Java 1.8 版本,Java Access Bridge 属于 JDK 的一部分,您无需单独下载。 使用控制面板启用 Java Access Bridge。

    • 如果您的屏幕阅读器为 32 位,请安装 32 位 JRE 版本 1.7 或更高版本。 如果您的屏幕阅读器为 64 位,请安装 64 位 JRE 版本 1.7 或更高版本。

    您的计算机可能同时存在 Java Access Bridge 的某些重要组件的多个版本,且这些版本之间可能不兼容。 您需要验证 Java Access Bridge 配置是否正确。

    如果您的屏幕阅读器为 32 位,请确保存在 C:\Windows\SysWOW64\WindowsAccessBridge-32.DLL ,且其版本号为 7.x.x.x 或更高。 该文件的说明应为 "Java(TM) Platform SE 7"。

  3. PyCharm 会在检测到已安装屏幕阅读器时自动显示提示,建议启用屏幕阅读器支持。

    首次启动 PyCharm 时,在打开的对话框中点击 启用

    对于已安装并配置的 PyCharm,也可以稍后或手动启用屏幕阅读器支持。

安装并设置 PyCharm

  1. 下载并安装 PyCharm。

  2. 要在首次启动 PyCharm 之前启用屏幕阅读器支持,请执行以下操作:

    1. 打开包含个人设置(例如键位映射、配色方案等)的 配置 目录。

      语法

      %APPDATA%\JetBrains\<product><version>

      示例

      C:\Users\JohnS\AppData\Roaming\JetBrains\PyCharm2025.3

      语法

      ~/Library/Application Support/JetBrains/<product><version>

      示例

      ~/Library/Application Support/JetBrains/PyCharm2025.3

    2. 创建名为 idea.properties 的文件。

    3. ide.support.screenreaders.enabled=true 属性添加到您创建的文件中。

  3. 启动 PyCharm。 位于 设置 | 外观与行为 | 外观 中的 支持屏幕阅读器 选项将被启用。

自定义 IDE

您可以根据自身的辅助功能需求自定义 IDE。

为红绿色觉缺陷调整颜色

如果您有红绿色觉缺陷,您可以调整 IDE 和编辑器的颜色。 此时,诸如错误(通常以红色高亮)或字符串(通常为绿色)等代码通知将以中性色显示。 测试运行器中的进度条颜色也会进行调整,以便更易识别。

  1. Ctrl+Alt+S 打开设置,然后选择 外观 & 行为 | 外观

  2. 选择 针对红-绿色觉缺陷调整颜色 并保存更改。

    请查看以下示例: 之前 的图像中, 字符串 以绿色高亮, 错误 以红色高亮; 之后 的图像中,颜色已调整:

    调整颜色之前的高亮显示
    调整颜色之后的高亮显示

为滚动条添加对比色

您可以使编辑器中的滚动条更显眼。

  1. Ctrl+Alt+S 打开设置,然后选择 外观 & 行为 | 外观

  2. 在右侧选项中,在 无障碍功能 部分下,选择 Use contrast scrollbars

    添加对比色之前的滚动条
    添加对比色之后的滚动条

配置代码元素、编辑器、滚动条、超链接等的颜色

您可以调整代码元素、错误、编辑器元素和工具窗口的颜色。 您还可以配置编辑器中垂直滚动条的颜色。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 配色方案 | 常规

  2. 在右侧的列表中,选择您想调整颜色的元素。 例如,您可以选择 代码 ,并调整注入语言片段或匹配括号等的颜色。 点击 确定 以保存更改。

您还可以调整调试器、控制台以及 IDE 其他部分的颜色:在位于 设置 | 编辑器 | 配色方案 的选项列表中选择相应的节点。

配置插入符号所在行的颜色

覆盖默认 UI 字体

您可以覆盖 UI 元素的默认字体。

  1. Ctrl+Alt+S 打开设置,然后选择 外观 & 行为 | 外观

  2. 在右侧选项中,从 使用自定义字体 列表中选择一种字体,并在 大小 字段中指定字号。

  3. 点击 确定 以保存更改。

更改 UI 图标和文本的大小

这样,UI 中图标和文本的大小将被调整。

调整工具窗口大小

您可以使用快捷键在垂直或水平方向调整工具窗口大小。

  • 要在垂直方向增大或减小高度,请按 Ctrl+Alt+Shift+UpCtrl+Alt+Shift+Down

  • 要在水平方向增大或减小宽度,请按 Ctrl+Alt+Shift+LeftCtrl+Alt+Shift+Right

调整编辑器中的文本大小

您可以更改编辑器中的文本字体和大小。

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

  2. 在右侧选项中,选择 使用 Ctrl + 鼠标滚轮更改字体大小(缩放) 选项,以便在编辑器中工作时快速更改文本大小(转动鼠标滚轮)。

  3. 如果您需要指定确切的字体大小,请选择 编辑器 | 字体

  4. 在右侧选项中,指定字体、其大小、行距以及其他可用选项。 点击 确定 以保存更改。

为所有 UI 元素设置缩放级别

您可以为整个 IDE 设置缩放级别,根据您的需求将其设置得比默认缩放更小或更大。

  1. 转到 视图 | 外观 并选择 缩放IDE

  2. 要预览不同的缩放级别,将鼠标悬停在弹出窗口中的选项上。

    IDE 缩放级别
  3. 点击所选缩放级别以应用更改。

  1. Ctrl+Alt+S 打开设置,然后选择 外观 & 行为 | 外观

  2. 辅助功能 部分,点击 缩放 字段并输入您的值。

    输入自定义缩放级别
  3. 点击 确定(O) 以应用更改。

自定义快捷键

您可以为常用操作配置自定义快捷键。

  1. Ctrl+Alt+S 打开设置,然后选择 键位图

  2. 在右侧的选项列表(如菜单、操作和工具)中,选择您需要的操作。

  3. 右键点击所选项,并在上下文菜单中选择要执行的操作,例如 添加键盘快捷键添加鼠标快捷方式添加缩写

    为操作添加键盘快捷键
  4. 在打开的对话框中,指定一个快捷键。 如有必要,选择 第二次按下 选项,并为该快捷键指定一个附加键。 要保存更改,请点击 确定 使用鼠标 (如果您按 Enter ,PyCharm 会将其视为快捷键)。

自定义智能键行为

您可以配置智能键的行为。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 常规 | 智能键

  2. 在右侧选项中,选中或清除智能键选项。 例如,您可以清除 插入成对括号插入成对引号 选项(它会自动插入右括号或引号),因为在使用屏幕阅读器时这可能不太有用。 点击 确定 以保存更改。

禁用自动代码补全

您可以禁用自动代码补全,以避免在使用屏幕阅读器在编辑器中工作时自动插入代码元素。

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

  2. 清除 类型匹配补全 选项。

自定义代码折叠

您可以控制代码折叠行为,并指定哪些内容应折叠或不应折叠。

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

  2. 在右侧选项中,选择默认应折叠的内容。

自定义代码样式

您可以配置空格、制表符和缩进。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 代码样式 | [Language]

  2. 在右侧选项中,点击 制表符和缩进 以配置制表符,或点击 空格 以配置空格的使用位置和方式。

  3. 点击 确定 以保存更改。

朗读编辑器中的装订线图标和行号

您可以配置屏幕阅读器朗读编辑器左侧装订线中的行号、VCS 注解、调试器及其他图标。

  1. 在编辑器中打开您的文件。

  2. Alt+Shift+6, F 将焦点移到装订线上。 PyCharm 将从当前插入符号所在的行开始朗读。

  3. 使用 向上向下 方向键在各行之间移动。 如果需要移动到该行中的下一个或上一个装订线元素,请分别使用 向右向左 方向键。

    当焦点位于装订线时,如果有可用的装订线图标工具提示,屏幕阅读器可以将其读出。

    要访问工具提示,请按下双重快捷键 Alt+Shift+6, T。 要逐字符浏览工具提示的内容,请使用 向右向左 方向键。

  4. Escape 将焦点切换回编辑器。

设置高对比度界面主题

您可以为 PyCharm 设置高对比度界面主题。 界面主题定义窗口、对话框和控件的外观。

  1. Ctrl+Alt+S 打开设置,然后选择 外观 & 行为 | 外观

  2. 主题 列表中,选择 高对比度 ,并点击 确定 以应用更改。

设置高对比度配色方案

您可以为编辑器设置高对比度配色方案。 PyCharm 使用配色方案,帮助您在编辑器中定义首选颜色和字体。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 配色方案 | 配色方案字体

  2. 配色方案字体 页面上,从 方案 列表中选择 高对比度

  3. 点击 确定 以应用更改。

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