VS Code无法解析嵌套Node项目的node modules问题求助

当在根项目中嵌套子Node项目时，VS Code打开根目录会出现Cannot find module or its corresponding type declarations错误，但单独打开子项目正常，核心原因是VS Code默认用根项目的配置进行全局检查，未识别子项目本地的node_modules和配置。以下是几种实用解决方案：

方案1：调整根项目的TypeScript/JavaScript配置 #

如果项目使用TypeScript（或JavaScript配合jsconfig.json），在根目录的tsconfig.json（或jsconfig.json）中添加子项目的依赖路径和文件范围：

{
  "compilerOptions": {
    // 包含子项目的类型定义目录
    "typeRoots": [
      "./node_modules/@types",
      "./子项目目录名/node_modules/@types"
    ],
    // 映射模块查找路径到子项目node_modules
    "paths": {
      "*": [
        "*",
        "./子项目目录名/node_modules/*"
      ]
    }
  },
  // 确保包含子项目的所有代码文件
  "include": [
    "src/**/*",
    "./子项目目录名/**/*"
  ]
}

保存后重启VS Code的TypeScript服务（按下Ctrl+Shift+P，选择TypeScript: Restart TS Server）。

方案2：配置VS Code工作区设置 #

在根项目的.vscode/settings.json中添加以下配置，让VS Code正确识别子项目的依赖：

{
  // 允许自动导入子项目package.json中的依赖
  "typescript.preferences.includePackageJsonAutoImports": "on",
  // 指定使用子项目的TypeScript版本（如果子项目TS版本与根项目不同）
  "typescript.tsdk": "./子项目目录名/node_modules/typescript/lib",
  // 不排除子项目的node_modules目录
  "files.exclude": {
    "./子项目目录名/node_modules": false
  },
  "search.exclude": {
    "./子项目目录名/node_modules": false
  }
}

方案3：将子项目添加为工作区独立文件夹 #

打开根项目后，点击左侧资源管理器顶部的添加文件夹到工作区，选中子项目文件夹。此时VS Code会分别加载两个项目的配置文件，各自使用本地的node_modules，错误会自动消失。

方案4：修正根目录的忽略规则 #

检查根项目的.gitignore文件，如果存在node_modules/规则，会导致VS Code默认排除所有子目录的node_modules。将其修改为/node_modules/（仅排除根目录的node_modules），就能让VS Code识别子项目的依赖目录。

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