如何配置VS Code解析相对于项目根目录的Node.js require路径

不需要修改VS Code全局设置，也不需要安装第三方插件，通过项目级配置就能让VS Code匹配NODE_PATH的模块解析逻辑。

核心配置方法 #

• 在项目根目录（即你启动应用时$PWD对应的目录）新建jsconfig.json文件
• 写入以下配置：

{
  "compilerOptions": {
    "baseUrl": "."
  },
  "exclude": ["node_modules"]
}

• 保存后等待VS Code重新完成项目索引，原本的路径无法识别提示就会消除，跨文件跳转、自动补全、引用查找等功能都会正常生效。

场景适配说明 #

• 如果你启动应用时NODE_PATH指向的不是项目根目录，比如是./src文件夹，只需要把配置里的baseUrl值改成对应相对路径即可，配置路径必须和运行时的NODE_PATH保持完全一致。
• TypeScript项目不需要额外创建jsconfig.json，直接在现有tsconfig.json的compilerOptions中添加相同的baseUrl配置即可，TS语言服务会自动读取该规则解析模块路径。
• 如果安装了路径补全类第三方插件（例如Path Intellisense），可以同步在插件配置中添加路径映射，保证补全逻辑和解析规则一致：

"path-intellisense.mappings": {
  "/": "${workspaceRoot}"
}

提示：不要在VS Code全局配置中添加全局NODE_PATH规则，上述项目级配置足够解决问题，把jsconfig.json提交到代码仓库后，团队其他成员拉取代码不需要额外修改本地配置，就能直接获得正确的路径识别效果。

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