VS Code中require用非字符串字面量时IntelliSense失效求助

VS Code的IntelliSense依赖静态代码分析，无法追踪动态拼接的模块路径（比如模板字符串、变量拼接），以下是几种可行的解决方法：

1. 配置路径别名（推荐） #

无论是JavaScript还是TypeScript项目，都可以通过配置文件定义路径别名，既方便统一修改基础路径，又能让IntelliSense正常识别：

1. 在项目根目录创建jsconfig.json（JS项目）或tsconfig.json（TS项目）；
2. 添加如下配置，将@myLib映射到你的库文件夹路径：

   {
     "compilerOptions": {
       "baseUrl": ".",
       "paths": {
         "@myLib/*": ["../../MyLibraries/*"]
       }
     },
     "include": ["**/*.js"]
   }
   

3. 之后引入模块时直接使用别名：

   const myLib = require('@myLib/myLibrary.js');
   const logger = require('@myLib/logger.js');
   

   后续如果库文件夹路径变更，只需修改jsconfig.json中的paths配置即可。

2. 用JSDoc注释辅助静态分析 #

如果需要保留自定义的requireFromLib函数，可以通过JSDoc注释给IntelliSense提供明确的类型提示：

针对单个模块 #

/**
 * 从自定义库路径加载模块
 * @param {string} file - 库中的目标文件名
 * @returns {import('../../MyLibraries/myLibrary.js')}
 */
function requireFromLib(file) {
    return require(`../../MyLibraries/${file}`);
}

const logger = requireFromLib('myLibrary.js');

通用型注释（适配多个模块） #

/**
 * 从自定义库路径加载模块
 * @param {string} file - 库中的目标文件名
 * @returns {import('../../MyLibraries/' + file)}
 */
function requireFromLib(file) {
    return require(`../../MyLibraries/${file}`);
}

这种方式会让IntelliSense根据传入的文件名，自动关联对应模块的类型和提示。

3. 调整VS Code的JavaScript偏好设置 #

在VS Code的settings.json中添加如下配置，优化模块导入的识别逻辑：

"javascript.preferences.importModuleSpecifier": "non-relative",
"javascript.suggest.autoImports": true

不过该配置仅作为辅助，核心解决还是依赖路径别名或JSDoc注释。

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