Yarn 4.1.0 Monorepo中VSCode跳转至定义功能失效的解决方法

• 安装Yarn PnP专属VSCode插件
  直接在VSCode扩展市场搜索Yarn Plug'n'Play并安装，它能让VSCode适配Yarn的PnP模块解析逻辑，不再依赖node_modules查找路径。

• 配置VSCode语言服务与别名映射
  在项目根目录创建.vscode/settings.json，添加以下配置：

  {
    "javascript.preferences.importModuleSpecifier": "non-relative",
    "typescript.preferences.importModuleSpecifier": "non-relative",
    "javascript.suggest.paths": true,
    "typescript.suggest.paths": true
  }
  

  另外根据项目类型补充别名配置：

  • TypeScript项目：在tsconfig.json里添加baseUrl和paths：

    {
      "compilerOptions": {
        "baseUrl": ".",
        "paths": {
          "@modules/*": ["./modules/*"]
        }
      },
      "include": ["**/*"]
    }
    

  • JavaScript项目：创建jsconfig.json，内容如下：

    {
      "compilerOptions": {
        "baseUrl": ".",
        "paths": {
          "@modules/*": ["./modules/*"]
        }
      },
      "include": ["**/*"]
    }
    

• 生成Yarn PnP SDK文件（推荐）
  在项目根目录执行命令：

  yarn dlx @yarnpkg/pnpify --sdk vscode
  

  这个命令会生成VSCode可识别的PnP映射文件，进一步优化模块路径解析能力。

• 重启VSCode加载配置
  按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），选择Reload Window，让所有配置生效。

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