使用Yarn Workspaces时node_modules缺失/src和/dist目录问题

针对你遇到的通过GitHub分支安装Workspaces结构的包后，node_modules中缺失/src和/dist目录的问题，给出以下排查方向：

• 验证子包配置的正确性
  聚焦你修改的子包（而非根目录）的package.json：

  1. 确认main/module等入口字段指向的文件路径真实存在，比如"main": "dist/index.js"需要确保dist目录已提交且包含对应文件。
  2. 子包的files字段需明确列出要包含的目录，示例配置：

     "files": [
       "src/",
       "dist/"
     ]
     

     注意：根目录的files配置不会覆盖子包，必须保证子包自身配置生效。

• 排查Git忽略规则的层级影响
  即便子包的.gitignore未排除dist/src，也要检查**根目录的.gitignore**是否存在全局忽略条目（比如dist/或src/）。Git会继承父目录的忽略规则，可能导致这些目录未被提交到远程分支。

• 确认Workspaces的子包范围
  检查根目录package.json的workspaces字段，确保你修改的子包在配置范围内，比如：

  "workspaces": [
    "packages/saber2"
  ]
  

  若Workspaces未包含该子包，yarn处理远程安装时可能无法识别其为有效子包，导致文件未被正确打包。

• 本地打包测试排除远程因素
  在子包目录执行yarn pack生成.tgz压缩包，然后在项目中执行yarn add ./path/to/xxx.tgz安装本地包。如果本地安装后文件正常，说明问题出在远程分支的提交或yarn远程打包逻辑；若本地安装仍缺失文件，则聚焦子包自身配置问题。

• 适配yarn版本的安装语法
  不同yarn版本对monorepo远程安装的处理逻辑不同：

  • 若用yarn 1.x，尝试指定子包路径安装：yarn add 'saber2@https://github.com/ilmoi/saber-common#ilmoi_support_v0:packages/saber2'（格式为#分支名:子包相对路径）。
  • 若用yarn 2+/berry，检查yarnrc.yml中的nodeLinker配置，避免使用pnp模式（该模式下node_modules结构特殊），可切换为node-modules模式重试。

• 确认远程分支的文件状态
  直接访问你的GitHub分支页面，导航到子包目录，确认src和dist目录确实存在且包含文件。可能存在提交未推送、分支切换错误等情况，导致远程分支缺少必要文件。

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