Yarn无法识别node_modules：Express+TypeScript环境配置求助

你的问题确实是因为新版Yarn（Yarn 2+，又称Berry）默认启用了**PnP（Plug'n'Play）**机制，不再生成传统的node_modules文件夹，导致VS Code类型检查器和TypeScript编译器无法识别依赖路径。下面提供两种解决思路：

一、切换回传统node_modules模式（快速落地） #

这是最直接的解决方式，让Yarn恢复生成标准node_modules：

1. 在项目根目录创建或编辑.yarnrc.yml文件，添加以下配置：

   nodeLinker: node-modules
   

2. 重新执行依赖安装，触发node_modules生成：

   yarn install
   

同时解决编译后找不到index.js的问题 #

检查你的tsconfig.json配置是否正确：

• 确保outDir指定了编译输出目录（比如./dist），rootDir指向源码目录（比如./src）
• 补充必要的Node.js兼容配置，示例如下：

  {
    "compilerOptions": {
      "outDir": "./dist",
      "rootDir": "./src",
      "target": "ES2020",
      "module": "CommonJS",
      "moduleResolution": "NodeNext",
      "esModuleInterop": true,
      "skipLibCheck": true,
      "strict": true
    },
    "include": ["src/**/*"]
  }
  

确认源码放在src目录下（比如src/index.ts），执行tsc编译后，再运行node dist/index.js即可正常启动服务。

二、适配Yarn PnP模式（保留新特性） #

如果想继续使用Yarn的PnP缓存机制，需要配置工具链兼容：

1. 安装Yarn官方TypeScript插件：

   yarn plugin import typescript
   

2. 在VS Code中安装Yarn Plug'n'Play扩展，让编辑器识别PnP的依赖路径，消除导入标红问题。
3. 修改tsconfig.json，添加PnP插件配置：

   {
     "compilerOptions": {
       "plugins": [{ "name": "@yarnpkg/plugin-typescript" }],
       // 其他必要配置同上述示例
     }
   }
   

4. 用Yarn代理执行编译和运行命令，确保依赖被正确加载：

   yarn tsc
   yarn node dist/index.js
   

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