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

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

> **TL;DR**
> `文件 | 设置 | 编辑器 | 语言注入`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 编辑器 | 语言注入`  适用于 macOS
>
>
>
> `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) !["设置"图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.settings.svg)

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

当您在 [语言注入](language-injections-settings.html) 设置页面上点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)   添加   并选择   泛型 Python  ，或在列表中选择 Python 受限标识符并点击 ![编辑按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.edit.svg)   编辑   时，将打开该对话框。

|  条目  |  描述  |
| --- | --- |
|  名称  |  注入的名称。  |
|  语言  |     要注入的语言。        * ID : 选择要 inject 的语言的 ID 或名称。    * 前缀 : 指定要添加到相应字符串值之前的字符序列。    * 后缀 : 指定要添加到相应字符串值之后的字符序列。      前缀和后缀是可选的。     |
|  位置模式集锦  |     在此字段中，输入规则，用于定义希望 IntelliJ IDEA 将文字识别为受限标识符的上下文。      > **Note:** > 这些规则由  程序结构接口模式  构建，实际上是内部 IntelliJ IDEA 语言的方法链式调用。 [程序结构接口](psi-viewer.html) 按 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 逻辑组合）。 请在单独的行中添加每个模式。      > **Warning:** > 如果您正在编辑预定义的受限标识符规则，模式已被指定。 它们可确保高效与易用。 建议您使用这些配置，而不是新建。    |
|  高级  |     在此区域，可以选择指定其他设置以缩小受限标识符规则的适用上下文，从而启用对注入过程更细致的控制。        * 值模式 输入确定 inject 语言上下文的正则表达式。 通过将模式的第一个捕获组用作受限标识符的目标，可以配置该过程，使语言仅被 inject 到匹配特定模式的值中，或被 inject 到匹配该模式的多个部分中。    * 单个文件 - 如果此选项关闭，与值模式匹配的片段将被单独处理，视为不同的“文件”——例如，从片段编辑器的视角来看。 如果该选项开启，相应片段会全部合并在一起，形成一个单元或“文件”。 给定值模式 `xxx (.+) yyy (.+) zzz` 以及片段 `xxx select * yyy from family zzz` ， 如果该选项关闭， `select *` 和 `from family` 会被视为两个独立片段（或“文件”）。 如果该选项开启， `select * from family` 会被视为一个单元或“文件”。    |

## See also

### 过程

[语言和引用受限标识符](using-language-injections.html)

### 参考

[语言注入](language-injections-settings.html) [正则表达式语法参考](regular-expressions.html)

