PhpStorm 2026.3 Help

语言注入设置对话框:JS Tagged Literal 注入

当您点击 "添加"按钮 并在上下文菜单中选择 JS 标记模板字符串注入 ,或选择一个条目并点击 编辑按钮 时,将打开该对话框。

PhpStorm 包含预定义的注入配置,可确保高效和易用。 我们建议您使用这些配置,而不是创建新的配置。

项目

描述

名称

注入的名称。

语言

要注入的语言。

  • ID: 选择要 inject 的语言的 ID 或名称。

  • 前缀: 指定要添加到相应字符串值之前的字符序列。

  • 后缀: 指定要添加到相应字符串值之后的字符序列。

前缀和后缀是可选的。

模板标签

在此字段中,指定一个或多个您希望模板字面量解析的函数。 使用点作为分隔符。

了解更多信息请参阅 Tagged Templates。

高级

在此区域,可以选择指定其他设置,以缩小注入规则适用的上下文,从而启用对注入过程更细粒度的控制。

  • 值模式 输入用于确定 inject 语言上下文的正则表达式。 通过将模式的第一个捕获组用作注入目标,您可以将该过程配置为仅将语言注入匹配某一模式的值,或注入匹配该模式的多个部分。

  • 单个文件 - 如果此选项关闭,与值模式匹配的片段将被单独处理,视为不同的“文件”——例如,从片段编辑器的视角来看。

    如果该选项开启,相应的片段将全部合并在一起,形成一个单元,或 "file"。

    鉴于此数值模式

    xxx (.+) yyy (.+) zzz

    以及片段

    xxx select * yyy from family zzz,

    如果该选项关闭, select * 和 from family 将被视为两个独立的片段(或 "文件")。 如果该选项开启, select * from family 将被视为一个单元,或 "文件"。

2026年 11月 9日