llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

语言注入设置对话框:泛型 Python

使用此对话框配置受限标识符规则,该规则会将语言 inject 到 Python 字符串文字中。

当您在 语言注入 设置页面上点击 "添加"按钮添加 并选择 泛型 Python ,或在列表中选择 Python 受限标识符并点击 编辑按钮编辑 时,将打开该对话框。

条目

描述

名称

注入的名称。

语言

要注入的语言。

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

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

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

前缀和后缀是可选的。

位置模式集锦

在此字段中,输入规则,用于定义希望 IntelliJ IDEA 将文字识别为受限标识符的上下文。

除了平台模式,例如 psiElement() 和 string() ,还可以使用以下 Python 特定模式:

  • pyLiteralExpression() :匹配文字表达式,例如字符串文字。

  • pyStringLiteralMatches("regexp") :匹配其值包含指定正则表达式匹配项的字符串文字。 匹配不区分大小写,并且 。 也匹配换行符。 文档字符串和 10,000 个或更多字符的字符串文字不匹配。

  • pyArgument("function_name", index) :匹配对具有指定名称的函数/方法或方法的调用中的实参。 index 是实参的从零开始的位置。 IntelliJ IDEA 将函数/方法名称与调用中的名称进行比较,并且不会解析函数/方法。

  • pyModuleFunctionArgument("function_name", index, "module_name") :匹配对在指定模块顶层定义的函数/方法的调用中的实参。 module_name 是不含扩展程序的模块文件名称,而不是模块的限定名称。 例如,对于 mypkg/db_utils.py ,指定 db_utils。

  • pyMethodArgument("method_name", index, "class_qualified_name") :匹配对在具有指定限定名称的类中定义的方法的调用中的实参。 对于继承的方法,请指定定义它的类。 IntelliJ IDEA 根据对象的推断类型解析调用,因此未知类型对象上的调用不匹配。

pyArgument()、 pyModuleFunctionArgument() 和 pyMethodArgument() 模式不匹配关键字实参,例如 execute(sql="...")。

要组合条件,请使用 .and()。

示例:

将语言 inject 到以 SELECT 开头的字符串文字中:

pyStringLiteralMatches("^\\s*SELECT\\s")

将语言 inject 到对名称为 execute 的任意函数/方法或方法的调用的第一个实参中:

pyLiteralExpression().and(pyArgument("execute", 0))

将语言 inject 到在 db_utils.py 中定义的 run_query() 函数/方法的第一个实参中:

pyModuleFunctionArgument("run_query", 0, "db_utils")

将语言 inject 到在 myapp/db.py 中定义的 仓库 类的 query() 方法的第一个实参中:

pyMethodArgument("query", 0, "myapp.db.Repository")

多个模式

可以为单个受限标识符规则定义多个位置模式。 如果有任一模式匹配,受限标识符将被激活(它们使用 OR 逻辑组合)。 请在单独的行中添加每个模式。

高级

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

  • 值模式 输入确定 inject 语言上下文的正则表达式。 通过将模式的第一个捕获组用作受限标识符的目标,可以配置该过程,使语言仅被 inject 到匹配特定模式的值中,或被 inject 到匹配该模式的多个部分中。

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

    如果该选项开启,相应片段会全部合并在一起,形成一个单元或“文件”。

    给定值模式

    xxx (.+) yyy (.+) zzz

    以及片段

    xxx select * yyy from family zzz,

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

2026年 11月 3日