WebStorm 2025.2 Help

高级设置

除了常用的标准设置之外,WebStorm 还提供多种高级选项,您可以使用这些选项来微调特定产品功能的行为。

由于高级设置包含多个部分,您可以使用搜索字段快速跳转到相关部分或所需选项。 您还可以搜索注册表项,因为某些高级选项与注册表项关联。

书签

项目

描述

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

默认情况下,WebStorm 仅在书签弹窗中显示行书签(Shift+F11编辑 | 书签 | 显示行书签…)。 如果您希望在弹窗中查看其他已加书签的项目,例如文件或文件夹,请禁用此选项。 如需详细信息,请参阅 书签

构建工具。 Gradle

项目

描述

下载源码

默认情况下,WebStorm 在初始项目同步时不会下载项目依赖项的源代码。

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

数据库

项目

描述

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

适用于 scripted data loaders 支持的文件格式。 定义 WebStorm 在表格视图中打开哪些文件。

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

  • 以表格为主的格式 :用于表示表格格式数据的所有文件格式所对应的文件。 当前支持的所有表格数据文件格式(不包括 JSON)。

  • :禁用所有文件的视图。

在“搜索任意位置”中显示“数据库”选项卡

搜索任意位置 (双击 Shift )中启用 数据库 选项卡。

有关 Search everywhere 功能的更多信息,请参阅 按名称搜索目标(全局搜索)

调试器

项目

描述

最近表达式的最大数量

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

Dev Containers

项目

描述

使用 --depth=1 克隆源码

使用此选项可通过检出源代码的最新版本来加快项目克隆过程。 有关详细信息,请参阅 Git documentation

Docker

项目

描述

重启时自动连接到Docker

在 WebStorm 启动后, 连接到配置的 Docker 守护进程

镜像注册表实体加载限制

出于性能考虑,默认情况下,WebStorm 仅显示 Docker registry 中前 100 个镜像。 如需列出更多,请增加此数值。 这也会增加内存使用量。

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

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

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

WebStorm 检查与 Docker 的连接状态的频率(以毫秒为单位)。

为 SELinux 系统中的几乎任何绑定卷应用 :z 挂载选项

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

编辑器

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

项目

描述

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

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

在未选中内容时执行复制操作后,不选中被复制的行

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

粘贴在未选中情况下复制的行时

您可以更改默认 粘贴到插入符号所在行的上方 行为,选择 粘贴到插入符号所在行 以恢复旧的复制/粘贴行为,或选择 如果粘贴的是中间行则进行裁剪 以在粘贴到行中间时移除复制行前后的多余空格。

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

选中此选项后,您可以使用特殊字符(如控制代码)的 Unicode 名称缩写形式。

显示缩放指示器

在编辑器中 缩放代码时,使用此选项可查看当前字体大小指示器以及还原为默认字体大小的选项。

制表符呈现

您可以选择以下选项之一:

  • 水平线

  • > 符号

  • 长箭头

免打扰模式下的左边距

使用此选项可在 专注模式和禅模式下调整编辑器左边距。

默认情况下,编辑器中这些查看模式下的文本会垂直居中,文本列宽与 在此处强制换行 选项在 编辑器 | 代码样式 设置页面 Ctrl+Alt+S 中所设置的值一致。 这意味着如果 格式正确后代码居中对齐,但存在很长且未换行的代码行,则文本可能会超出可视区域,而左侧边距依然较大。 在这种情况下,您可能需要使用此选项来减小左侧边距。

行号字体增量

使用此选项可相对于编辑器字体大小修改左侧边距中行号的字体大小。

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

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

使用“扩展选区”时选中空白字符

使用此选项可在调用 Extend Selection操作时包括空格。

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

此选项允许您配置在 使用行注释注释一行时是否将插入符号移动到下一行 Ctrl+/。 请注意,如果编辑器中有选中内容,无论此选项是否启用,插入符都不会移动。

编辑器选项卡

除了 WebStorm 在编辑器中 使用选项卡时提供的标准 编辑器选项卡选项外,本部分还包含作为内部注册表操作可用的附加选项。

项目

描述

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

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

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

当您导航到方法、类或变量时,如果当前标签页中没有更改,包含其声明的源文件将替换当前标签页。

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

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

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

启用此选项后,您可以双击编辑器选项卡以 隐藏并还原所有工具窗口。 或者,您也可以按 Ctrl+Shift+F12 ,或从主菜单中选择 窗口 | 活动工具窗口 | 隐藏所有窗口/恢复窗口 来执行此操作。

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

启用此选项后,您可以双击 拆分的编辑器选项卡组中的选项卡来更改选项卡组的相对大小:首次双击将最大化该选项卡及其所在的组,并将其他组最小化;第二次双击将为每个选项卡组分配相同的宽度和高度。

或者,您可以从主菜单中选择 窗口 | 编辑器标签 | 最大化编辑器/标准分屏 ,或从 查找操作弹出窗口中选择这些操作 Ctrl+Shift+A

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

在嵌套分屏中等比例分配区域

使用此选项可让编辑器中多个水平或垂直拆分的尺寸保持一致。

将固定的标签页留在左侧

始终将 固定选项卡移至编辑器选项卡栏的左侧。 否则,固定选项卡的位置未定义,您可以在选项卡栏上根据需要移动它们。

查找 / 替换

使用本部分配置与 在项目中查找目标 搭配使用时的附加选项。

项目

描述

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

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

更多信息,请参阅 在项目中查找用法

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

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

GraphQL

使用此部分配置架构功能的检测。

项目

描述

架构功能检测模式

从此列表中选择以下模式之一:

  • 自适应 — 启用此模式后,WebStorm 将运行一个额外的预查询,以从 GraphQL 服务器请求实际可用的功能集合。

  • 最新 — 选择此模式可启用现代 GraphQL 服务器的所有默认功能,而无需运行预查询并检测实际可用功能。

  • 旧版 — 选择此模式可禁用旧 GraphQL 实现的所有默认功能,而无需运行预查询并检测实际可用功能。

在内省查询中跳过默认值

选中此复选框可提高与不兼容端点的兼容性。 其副作用是会从架构中删除默认值信息。

在内省结果中包含空类型

默认情况下,空类型会包含在 introspection 结果中。 若要跳过空类型,请取消选中该复选框。

了解详情,请参见 检测服务器功能

IDE

使用本部分配置存储项目中不同实体的附加选项。

项目

描述

最近项目的最大数量

使用此选项可更改默认的“最近的项目”存储数量,当前为 50

最近文件的最大数量

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

最近位置的最大数量

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

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

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

Kubernetes

项目

描述

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

选中此项后,如果没有可用的集群,WebStorm 会在 服务 工具窗口中显示 Kubernetes 节点。

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

指定 WebStorm 尝试加载的 kubeconfig 文件的最大大小(以兆字节 MB 为单位)。

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

指定 WebStorm 尝试加载的资源 YAML 文件的最大大小(以兆字节 MB 为单位)。

kubectl 集群操作超时

指定 WebStorm 等待 kubectl 集群操作完成的超时时间(以秒为单位)。 如果某个操作耗时过长,将因延迟或无响应而被取消。

HTTP 请求超时时间

指定 WebStorm 等待发送到 Kubernetes 集群的 HTTP 请求的超时时间(以秒为单位)。 如果某个请求耗时过长,将因延迟或无响应而被取消。

Markdown

项目

描述

隐藏浮动工具栏

在 Markdown 文件中选择部分文本时,WebStorm 会显示一个包含各种格式选项的 浮动工具栏。 如果您不希望看到浮动工具栏,请选中此复选框,然后重新打开选项卡以应用更改。

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

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

项目视图

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

项目

描述

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

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

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

选中该选项后,WebStorm 会折叠父节点及其子节点。

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

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

未选中库文件
选中库文件

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

选择已打开的文件

增大项目视图中的字号

如果希望更改 项目 视图中的字体大小,请选中此选项。 您需要重新启动 WebStorm。

Rails

项目

描述

自动加载 generator

该选项默认启用,使用该选项可自动加载 Rails generator。 禁用此选项后,您仍然可以手动触发该操作。

Rake

项目

描述

自动加载 task

该选项默认启用,使用该选项可自动加载 Rake task。 禁用此选项后,您仍然可以手动触发该操作。

运行/调试

项目

描述

临时配置限制

使用此选项更改存储的临时 run/debug configuration 的默认数量,该值为 5

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

当重新运行正在运行的进程时,WebStorm 会提示您确认终止现有进程并启动新进程的操作。 您可以通过取消选中此复选框来更改默认行为。

将配置设为默认固定

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

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

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

SSH

项目

描述

配置文件解析器

选择一个解析器:

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

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

OpenSSH 工具的自定义路径

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

全局搜索

项目

描述

在“搜索任意位置”中显示文本搜索结果

搜索任意位置 中启用 文本搜索。 结果将显示在新的 文本 选项卡以及列表底部的 全部 选项卡中。

在显示结果前等待所有贡献者完成

等待所有搜索提供方完成任务后再显示最终搜索结果。 此选项会固定搜索结果中某项的位置,防止其在列表中跳动。 如果存在响应较慢的搜索提供方,此选项可能会降低“全局搜索”的操作速度。

贡献者等待超时(毫秒) 字段中,指定等待搜索提供方完成任务的时间。

根据机器学习在“操作”选项卡中排序结果

默认情况下, 操作 选项卡中的搜索结果将使用机器学习进行排序,而不是使用标准排序算法。

根据机器学习在“文件”选项卡中排序结果

默认情况下, 文件 选项卡中的搜索结果将使用机器学习进行排序,而不是使用标准排序算法。

根据机器学习在“全部”选项卡中排序结果

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

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

如果希望 WebStorm 在 操作 选项卡中使用语义搜索(通过分析查询意图和上下文含义的技术),以获得更相关的结果,请选中此选项。

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

如果希望 WebStorm 在 文件 选项卡中使用语义搜索(通过分析查询意图和上下文含义的技术),以获得更相关的结果,请选中此选项。

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

如果希望 WebStorm 在 符号 选项卡中使用语义搜索(通过分析查询意图和上下文含义的技术),以获得更相关的结果,请选中此选项。

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

如果希望 WebStorm 在 选项卡中使用语义搜索(通过分析查询意图和上下文含义的技术),以获得更相关的结果,请选中此选项。

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

项目

描述

保留上次选中的搜索范围

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

启动

项目

描述

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

如果选中此选项,在启动项目时如未打开任何文件,WebStorm 将打开一个 README.md 文件。

终端

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

项目

描述

终端回滚缓冲区大小

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

使用Escape 将焦点移至编辑器

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

键盘缓冲

启用终端中的 Typeahead 功能,在远程连接并预期输入延迟时非常有用。

键盘缓冲延迟阈值

当终端延迟超过指定值(以毫秒为单位)时启用 Typeahead。

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

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

填充字符背景(包括行间距)

如果备用屏幕缓冲区模式下的行距值大于 1.0,行间可能会出现水平白缝。 选中此复选框以填补这些缝隙。

显示应用程序标题

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

终端字符编码

为终端指定编码格式。

测试索引任务

项目

描述

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

您可以像监控其他 后台任务 一样,在进度条中监控并暂停或取消测试索引。 该选项默认启用。

测试索引在达到指定超时时间(毫秒)后以后台任务形式显示

此选项设置在测试索引作为后台任务出现在进度条中的时间阈值。

工具窗口

项目

描述

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

默认情况下,工具窗口标题中的图标(例如, 隐藏选项 )仅在鼠标悬停在工具窗口上或工具窗口获取焦点时显示。

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

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

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

禁用此选项时,您可以通过拖动工具窗口栏、使用 移动到 上下文菜单项或位于 工具窗口选项菜单选项 图标下的工具窗口设置来 移动工具窗口

用户界面

项目

描述

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

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

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

如果您希望以文字而非符号形式查看快捷键,请选择此选项。

在列表和树中循环滚动

按住向上键时选中最后一个元素,反之亦然。

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

选中此选项后,鼠标指针将定位到对话框中的默认按钮(通常是 确定)。

禁用双击修改键快捷键

您可以禁用使用双键的快捷键。 例如, ShiftCtrl

版本控制

项目

描述

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

选中此选项后,差异查看器将作为编辑器标签页显示。

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

选中此选项后,WebStorm 会在您在编辑器中打开文件时加载注释。

高亮显示忽略的文件

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

启用“提交”工具窗口

选择此选项后,WebStorm 会在一个独立的工具窗口中显示 本地更改搁置 标签页。

切换提交控件

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

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

选中此选项后,WebStorm 默认会选择所有将被推送的提交。

版本控制。 Git

项目

描述

递归克隆项目中的子模块

选中此选项后,从 Git 检出时将使用 git clone --recurse-submodules ,该命令会克隆主仓库及所有可用子模块。

从Git 读取时应用内容转换

选中此选项后,WebStorm 在从 Git 读取文件内容时会在 git cat-file 命令中使用 --filters--textconv 参数。

使用安全强制推送

选中此选项后,在 IDE 中执行强制推送操作时,WebStorm 将使用 --force-with-lease ,而不仅是 --force

检查传入和传出提交

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

不运行Git 提交挂钩

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

最后修改日期: 2025年 9月 26日