WebStorm 2025.2 Help

JavaScript 后缀模板

后缀代码补全可让您在刚键入的表达式周围添加模板代码。 当您在点号后键入模板缩写(后缀)并按下展开键(默认是 Tab ),或在代码补全弹窗中选择此缩写时,模板会展开。

WebStorm 附带了一组预定义的后缀模板,并允许您为 JavaScript 和 TypeScript 自定义模板,参见 创建自定义模板。 请注意,JavaScript 的预定义模板同样适用于 TypeScript 文件。

自定义模板可以复制、更新和删除。 对于预定义模板,您只能更改其后缀,例如,将较长的键替换为较短的键。

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

  2. 在打开的 后缀补全 页面中,选中 启用后缀模板 复选框。

    该页面显示了可用后缀及其对应模板的列表。 选择一个后缀时, 描述 窗格会演示相应的转换,并展示模板展开前后的代码片段。

    要启用某个后缀,请选中其旁边的复选框。

应用后缀模板

  1. 键入一个表达式并添加点号。

  2. 键入后缀并按下展开键(默认是 Tab )或从建议列表中选择后缀。 如有必要,选择要包裹或替换的表达式。

    所有后缀模板的默认展开键是 Tab。 请参见 更改默认展开键 了解如何选择其他按键。

创建自定义模板

  1. 设置 对话框(Ctrl+Alt+S )中,进入 编辑器 | 常规 | 后缀补全

  2. 在打开的 后缀补全 页面中,点击 添加按钮 ,然后选择模板适用的语言。 您可以选择 JavaScript 与 TypeScriptTypeScript

    创建自定义后缀模板:调用对话框
  3. 在打开的 创建新模板 对话框中:

    • 字段中指定模板后缀。

    • 最低语言等级 列表中选择语言级别。

    • 输入模板代码,并在需要插入初始表达式的位置添加 $EXPR$。 在希望最终光标所在位置添加 $END$

      后缀补全:创建自定义模板
    • 默认情况下,如果所调用的模板技术上适用于多个表达式,WebStorm 会提示您选择所需的表达式。

      若要在调用模板时让 WebStorm 自动转换最上层的适用表达式,请选中 应用于最外层表达式 复选框。

  4. 与使用预定义模板的方式相同,您可以使用新创建的自定义模板:键入模板表达式并加上点号,再键入后缀,例如 sum.write ,然后按下展开键(Tab)。

请参见下文中的 创建 React 组件模板 了解另一个自定义模板示例。

您还可以基于现有模板创建稍有不同的新模板,例如,语言上下文不同或光标最终位置不同。 WebStorm 可让您复制原始模板并在该副本中进行必要的更改。

基于现有模板创建新的自定义模板

  1. 设置 对话框(Ctrl+Alt+S )中,进入 编辑器 | 常规 | 后缀补全

  2. 在打开的 后缀补全 页面中,选择要复制的自定义模板,然后点击工具栏上的

  3. 在打开的 编辑模板 对话框中,根据需要编辑模板并输入新的后缀。

更改默认展开键

  • 设置 对话框(Ctrl+Alt+S )中,进入 编辑器 | 常规 | 后缀补全 ,然后从 展开模板使用 列表中选择新的按键。

禁用后缀补全

  • 要禁用所有已配置的后缀模板展开,请取消选中 启用后缀模板 复选框。

  • 要禁用特定模板的展开,请取消选中其后缀旁的复选框。

示例:创建 React 组件模板

以下是一个模板示例,该模板将展开为新 React 组件的类。

创建新的 React 组件模板

  1. 设置 对话框(Ctrl+Alt+S )中,进入 编辑器 | 常规 | 后缀补全

  2. 在打开的 后缀补全 页面中,点击 添加按钮 ,然后选择 JavaScript创建新模板 对话框打开。

  3. 字段中,输入 rcomp 缩写。

  4. 最低语言等级 列表中选择 ECMAScript 6+。 这意味着该模板仅适用于语言级别为 ECMAScript 6+Flow 的 JavaScript 文件。

    请参阅 选择 JavaScript 语言版本 了解详情。

  5. 键入包含 $EXPR$ 的模板文本,以标记初始表达式(以 .rcomp 开头)出现的位置。 请勿忘记在模板展开后希望光标所在的位置添加 $END$

    class $EXPR$ extends Component { render() { return ( <div> $END$ </div> ); } } export default $EXPR$;

应用新的 React 组件模板

  1. 在编辑器中,键入新组件的名称 Button ,然后输入一个点。

  2. 在建议列表中选择 rcomp。 WebStorm 会生成一个类 Button ,并将光标放置在原先变量 $END$ 所在的位置。

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