如何解决JetBrains IDE中注入JavaScript的未识别函数/类警告？

我在使用Rider（基于ASP.NET Core C#）开发时，遇到一个问题：当JavaScript的函数、类或成员声明在通过/* lang=javascript */注入的字符串插值变量中时，IDE会提示“未识别”的警告。这个问题同样出现在PhpStorm中，推测PyCharm也存在类似情况。

代码示例 #

public abstract class SelectorScript
{
    public static GlobalDefinition chooseProduct { get; } = new();

    public static ScriptFile File()
    {
        return new ScriptFile(
            /* lang=javascript */
            $$"""
                /**
                 * @param {string|Node|$Selector|Window} selector - element or selector
                 * @param {Document|Node} [baseElement] - base element
                 * @returns $Selector
                 */
                $S = (selector, baseElement = document) => {
                    return (new $Selector).$set(selector, baseElement);
                }
          """);
    }
}

代码中的$S、$Selector等标识符会被IDE标记为未识别的变量/类型，弹出类似“Unresolved variable”的警告。

解决方法 #

1. 为注入的JS代码添加类型声明

在注入的JavaScript代码开头，使用JSDoc注释定义全局类型或变量，让IDE识别这些标识符：

/**
 * @global
 * @typedef {Object} $Selector
 * @property {function(string|Node|$Selector|Window, Document|Node): $Selector} $set
 */
/** @global {function(string|Node|$Selector|Window, Document|Node): $Selector} $S */

/**
 * @param {string|Node|$Selector|Window} selector - element or selector
 * @param {Document|Node} [baseElement] - base element
 * @returns $Selector
 */
$S = (selector, baseElement = document) => {
    return (new $Selector).$set(selector, baseElement);
}

通过JSDoc明确类型后，IDE就能正确识别这些标识符，不再触发警告。

2. 全局调整IDE检查规则，忽略特定标识符

• 打开IDE设置（File > Settings 或快捷键 Ctrl+Alt+S）
• 导航到 Editor > Inspections > JavaScript > General > Unresolved variable
• 点击「Add」按钮，输入需要忽略的标识符（如$S、$Selector），并将作用域限定为「语言注入的JavaScript代码」或当前项目
• 保存设置后，IDE将不再对这些标识符触发未识别警告。

3. 单行注释抑制警告

如果仅需处理零散的未识别标识符，可以在对应代码行上方添加抑制注释：

// noinspection JSUnresolvedVariable
$S = (selector, baseElement = document) => {
    // noinspection JSUnresolvedVariable
    return (new $Selector).$set(selector, baseElement);
}

这种方式适合局部调整，无需修改全局设置。

内容的提问来源于stack exchange，提问作者Baekhan Sung