WebStorm 2025.2 Help

文件类型关联

对于不同语言和技术的文件中的语言特性(如语法高亮和 代码分析 ),WebStorm 维护一个 文件类型 列表,每个文件类型将语言服务与一个或多个文件名模式关联。

默认的文件类型列表涵盖了所有相关的文件名模式,但您可以为自定义语言文件 添加新的文件类型 ,也可以为已有文件类型 更改关联的文件名模式

当您在编辑器中打开文件时,WebStorm 会根据文件名模式选择文件类型及其对应的语言服务。 如果文件名与任何已注册文件类型的模式都不匹配,则以 按内容检测 文件类型打开该文件。

此外,您还可以 将 WebStorm 设置为默认应用程序 ,用于从操作系统的文件管理器中打开特定文件类型。

添加自定义文件类型

如果使用的语言默认不支持,且没有可用的 插件 ,您可以为该语言相关的文件配置简单的语言服务 — 这样即可享受关键字、注释及括号的语法高亮,还能获得添加行注释/区块注释 Ctrl+/Ctrl+Shift+/ ,以及根据结构扩展/收缩选区 Ctrl+WCtrl+Shift+W 等基础的编辑器辅助功能。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器|文件类型

  2. 识别的文件类型 部分,点击 添加按钮 ,指定新类型名称,并提供描述。

  3. 语法高亮显示 部分,配置大小写敏感性、括号匹配设置,并指定注释的定义方式:

    • 行注释 :指定表示单行注释起始的字符。

    • 仅限行首 :表示行注释起始的字符在位于行首时会被识别为注释。

    • 块注释开始块注释结束 :指定代表区块注释起始和结束的字符。

    • 十六进制前缀 :指定表示后续为十六进制数值的字符(例如, 0x)。

    • 数字后缀 :指定表示数值系统或单位的字符。 后缀是尾随的字符字符串(例如, e-3, kg)。

    • 支持配对大括号(R)支持配对中括号(C)支持配对小括号(P)支持字符串转义(E) :选中这些复选框可高亮匹配的花括号、方括号、圆括号和字符串转义字符。

  4. 关键字 部分,您可以最多指定四个关键字列表。 编辑器中每个列表的关键字将以不同方式高亮,并支持自动补全。

  5. 忽略情况(I) 复选框指示自定义格式文件中的关键字是否区分大小写。

  6. 您可以在 编辑器| 配色方案| 用户定义的文件类型 设置 页面上自定义语言相关关键字、注释和其他标识符的语法高亮颜色。

创建新文件类型

配置文件名模式与文件类型之间的关联

将文件名模式与文件类型关联

  1. 如果 WebStorm 无法识别您要打开或创建的文件类型,则会显示 注册新文件类型关联 对话框,您可以在其中选择想要处理该文件的方式。

    如果对话框未自动显示,请在 项目 工具窗口中右键点击文件,然后在上下文菜单中选择 与文件类型关联… ,或在主菜单中选择 文件| 文件属性| 与文件类型关联…

  2. 注册新文件类型关联 对话框中,选择所需选项:

    WebStorm:将文件名模式与文件类型关联
  3. 文件模式(P) 列表中,选择是只为当前文件指定类型( file.extension ),还是为所有此类扩展名的文件指定类型( *.extension )。

  4. 选择以下选项之一:

    • 以文本方式打开匹配的文件,并根据内容自动检测文件类型 :将无扩展名的文件作为文本文件打开,并根据内容(例如 shebang 行)识别文件类型。

    • 在 WebStorm 中打开匹配的文件 :将文件与现有文件类型之一关联。 您可以稍后在设置中 更改此关联

    • 在关联的应用程序中打开匹配文件 :在操作系统中配置的默认系统应用程序中打开该文件。 例如, .pdf 文件会在默认的 PDF 查看器中打开。

      如有必要,您可以 检查并配置与系统应用程序关联的所有文件名模式。

  5. 单击 确定 应用设置。

更改与文件类型关联的文件名模式

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器|文件类型

  2. 识别的文件类型 列表中,选择要与其他文件名模式关联的文件类型。

  3. 使用 文件名模式 部分进行必要的更改。 您可以添加新模式(添加按钮 ),移除已有模式(移除按钮 ),或修改已有模式(编辑按钮)。

    WebStorm:更改文件类型与相关文件名模式之间的关联

如果您的 项目 包含专有格式文件(如 .pdf .docx ),则 WebStorm 会使用操作系统中配置的默认应用程序打开这些文件。 当某一专有文件格式无法识别,或您希望使用系统应用程序打开特定文件时,您可以添加相应的关联。

配置与系统应用程序关联的文件名模式

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器|文件类型

  2. 识别的文件类型 列表中,选择 文件在关联的应用程序中打开

  3. 在右侧的 文件名模式 部分中,单击 添加按钮 并指定应与外部应用程序关联的文件名模式。

如果一个文件通过其文件名模式已正确关联至某一特定文件类型,但您希望以不同方式处理该文件,您可以仅为此文件覆盖文件类型关联 —— 其他匹配该模式的文件将不受影响。

为特定文件重写文件类型

  1. 项目 工具窗口中 Alt+1 ,选择一个或多个需使用其他文件类型关联的文件,右键点击所选内容并选择 重写文件类型

  2. 在打开的列表中选择新的文件类型。

    从项目工具窗口更改文件类型
  3. 若要根据文件名模式恢复原始文件类型关联,请再次右键点击文件或多个文件,并在上下文菜单中选择 还原文件类型覆盖

    还原文件类型重写

将 WebStorm 设置为特定文件类型的默认应用程序

您可以将 WebStorm 设置为操作系统默认文件管理器中打开特定文件类型的默认应用程序。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器|文件类型

  2. 点击 将文件类型与 WebStorm 关联 并选择要使用 IDE 打开的文件扩展名。

    WebStorm:将文件类型与 IDE 关联
  3. 点击 确定 并关闭对话框。

忽略文件和文件夹

WebStorm 还维护一个完全排除在任何处理之外的文件和文件夹列表。 该列表默认包含临时文件、与版本控制系统相关的服务文件等:

*.pyc;*.pyo;*.rbc;*.yarb;*~;.DS_Store;.git;.hg;.svn;CVS;__pycache__;_svn;vssver.scc;vssver2.scc;

修改忽略的文件与文件夹列表

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器|文件类型

  2. 切换到 忽略的文件和文件夹 选项卡。

    您可以添加新扩展名(添加按钮 )、移除已有扩展名(移除按钮 ),或修改已有扩展名(编辑按钮)。

  3. 应用更改并关闭对话框。

将文件和文件夹添加到忽略项列表

为文件类型配置 shebang 命令

WebStorm 可通过 shebang 行中指定的路径识别文件类型,在不考虑扩展名的情况下以相应图标标记文件,并提供语言感知的语法高亮。 shebang 是脚本文件中的一组字符,后跟应执行该脚本的解释器程序的路径。 它以 #! 开头,始终位于脚本文件的第一行。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器|文件类型

  2. 识别的文件类型 列表中,选择要为其配置命令的文件类型。

  3. HashBang 模式 区域中,单击 添加按钮添加HashBang 模式)。

  4. 在打开的对话框中,指定 IDE 用于识别文件类型的模式,然后点击 确定

  5. 应用更改并关闭对话框。

    为 CoffeeScript 配置 shebang 命令
最后修改日期: 2025年 9月 26日