语言与引用注入

通过语言注入，您可以处理与文件主语言不同的编程语言代码片段。

当您将一种语言（例如 HTML、CSS、XML、RegExp 等）注入字符串字面量时，即使这不是项目的主语言，您也可以获得针对该注入代码的全面编码辅助。

除了语言注入之外，IDE 还支持引用注入，它将字符串字面量视为对其他实体（如类或文件）的引用。

添加语言注入

添加临时语言注入

将插入符号置于要注入语言的字符串字面量、标签或属性内，然后按下 Alt+Enter （或使用意图操作图标）。
选择注入语言或引用，然后选择要注入的语言。

添加持久性语言注入

使用语言注入注释（注解）来添加持久性的注入语言片段。

在目标字符串字面量之前添加一个空行，然后输入以下注释：
# language=<language_ID>
对于注释，请使用要注入语言的语法。语言 ID 通常是直观的，例如 SQL、RegExp、XML、HTML。
您也可以在设置中了解语言 ID。按下 Ctrl+Alt+S 以打开设置，然后选择编辑器 | 语言注入。双击某种语言的注入规则；该语言 ID 在 ID 字段中指定。
（可选）在注释中包含前缀或后缀。
# language=<language_ID> prefix=<prefix> suffix=<suffix>
在以下情况下需要这样做：
- 该字符串是一个不完整/部分的 SQL 语句
- 该字符串未直接用于我们支持的调用之一（例如 select /where)

编辑已注入的语言片段

PyCharm 允许您在专用编辑器中编辑已注入的语言片段。

打开片段编辑器

将插入符号置于已注入的代码片段内，然后按下 Alt+Enter （或使用意图操作图标）。
选择编辑 <language ID> 片段。
PyCharm 将打开一个用于编辑注入语言代码的专用编辑器部分。此编辑器提供完整的编码辅助，包括代码补全、检查、意图操作以及代码样式操作。

注入引用

引用注入将字符串字面量解释为指向其他实体（如文件）的链接。

例如， resources/settings.yaml 可以被视为对文件的引用。

添加临时引用注入

将插入符号置于要注入引用的字符串字面量内，然后按下 Alt+Enter （或使用意图操作图标）。
选择注入语言或引用，然后选择一个选项。例如，文件引用会添加指向指定文件的链接。
根据您安装的插件，可能会有其他引用选项可用。

添加持久性引用注入

使用注释添加持久性引用注入。

在目标字符串字面量之前添加一个空行，并输入带有所需值的 # language= 注释。

例如， # language=file-reference 会添加对文件的引用：

from pathlib import Path def print_file_path(path: str): print(f"File path: {Path(path).resolve()}") def main(): # language=file-reference print_file_path("src/main/resources/settings.yaml") if __name__ == "__main__": main()

取消注入

取消持久性语言注入

要取消语言注入，请删除您用于引入它的注释（注解）。

取消临时语言注入

将插入符号置于该代码片段处，然后按下 Alt+Enter （或使用意图操作图标）。
选择取消注入语言或引用。

禁用意图操作灯泡图标

要在编辑器中隐藏意图操作图标，请执行以下操作：

按下 Ctrl+Alt+S 打开设置，然后选择编辑器 | 常规 | 外观。
清除显示意图灯泡复选框。
应用更改并关闭对话框。

配置自动注入规则

在 PyCharm 中， IDE 会根据一组预定义规则在您的代码中特定位置自动注入语言。

您可以在编辑器 | 语言注入设置页面  Ctrl+Alt+S 上配置语言注入规则。

所有预定义的注入规则均配置为内置作用域。换言之，它们是全局的（因此在所有 PyCharm 项目中可用）。自定义规则可以配置为 IDE 级别，或仅针对单个项目。要更改自定义注入的作用域，请使用。

要通过 VCS 共享自定义规则，请使用工具栏上的相应选项将其移动到项目作用域。这样，您将在 .idea 目录中创建一个名为 IntelliLang.xml 的新文件，其中包含您的自定义规则，您可以将其置于版本控制之下。

如果您不使用 VCS，您可以通过将规则导出为 XML 文件（点击工具栏上的），然后将其导入到另一个项目，来共享您的规则。

要配置自定义注入规则，点击以添加新规则，或复制一个预定义规则并更改其设置。

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