Yarn PnP模式下Workspaces无法正常工作？如何实现跨包导入？

可以在Yarn PnP模式下正常使用Workspaces，问题根源在于PnP不依赖node_modules的软链接，而是通过自身的依赖解析机制处理包关联，只要配置正确就能实现跨包导入。以下是具体配置步骤：

1. 根目录核心配置 #

确保根目录的package.json正确声明Workspaces，且标记为私有（避免被误发布）：

{
  "private": true,
  "workspaces": [
    "packages/*" // 根据你的包目录结构调整，比如"packages/first", "packages/second"
  ]
}

2. 启用PnP模式 #

在根目录的.yarnrc.yml中明确设置PnP作为链接器：

nodeLinker: pnp

PnP模式下不会生成软链接，这是正常行为，无需额外配置symlink相关参数。

3. 声明包间依赖关系 #

在需要跨包导入的项目（比如first包）的package.json中，将依赖的本地包（比如second包）添加到依赖列表，版本号用*即可匹配本地包版本：

{
  "name": "first",
  "dependencies": {
    "second": "*"
  }
}

这一步是关键，Yarn PnP需要通过这个依赖声明识别出这是Workspace内部的包，从而正确解析导入路径。

4. 规范导入方式 #

导入时使用目标包在package.json中声明的name字段，而非相对路径（相对路径也可工作，但依赖声明的方式更符合Monorepo规范）：

// first包的index.js
const { someData } = require('second');
// 或ES模块语法
import { someData } from 'second';

5. 正确执行脚本 #

PnP模式下不要直接用node命令运行脚本，需通过Yarn启动（Yarn会自动加载PnP解析器）：

# 运行first包的start脚本
yarn workspace first start

# 或直接运行指定文件
yarn node packages/first/index.js

如果必须直接用node命令，需要手动加载PnP的解析器：

node -r .pnp.cjs packages/first/index.js

常见排查点 #

• 检查每个包的package.json中的name字段是否与导入时的名称完全一致；
• 确保根目录package.json的private字段设为true，否则Yarn不会将其识别为Monorepo根包；
• 若使用TypeScript，需通过yarn dlx @yarnpkg/sdks vscode生成编辑器的PnP支持配置，避免编辑器报错。

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