使用CRA后单仓项目各子目录生成独立node_modules问题咨询

为什么子项目会生成独立的node_modules？ #

这是npm workspaces的正常行为，结合CRA的特性，核心原因有几点：

• CRA的专属依赖设计：react-scripts是CRA项目的核心构建工具，它被设定为项目级依赖（必须在子项目package.json中声明），npm workspaces不会强制将其hoist到根目录——毕竟每个CRA项目可能需要独立的脚本版本来适配自身需求。
• 子项目自有依赖声明：如果server或build-config目录的package.json自己声明了dotenv这类依赖，而根目录package.json未包含这些依赖，npm会自动在子项目目录下安装它们，这是workspaces“按需分配依赖”的标准逻辑。
• hoisting限制：部分依赖因为存在peer依赖冲突、版本不兼容，或者包结构本身不支持hoist（比如一些旧版工具），npm会自动将它们留在子项目的node_modules中，避免破坏整体项目的运行稳定性。

优化建议 #

• 明确依赖分层管理：
  • 把跨子项目共享的依赖（比如react、react-dom、typescript）移到根目录package.json中，删除子项目里对应的声明，npm会自动将其hoist到根目录，避免分散安装。
  • 保留子项目专属的依赖（比如仅web-client用的react-scripts、仅server用的dotenv）在各自的package.json里，这不会造成冗余，反而能保证子项目的独立性。
• 手动触发依赖合并：在根目录执行npm dedupe命令，让npm自动检查并合并可共享的依赖，尽可能减少子项目的node_modules数量。
• 调整hoisting配置（可选）：在根目录package.json中添加以下配置，开启强制hoist：

  "workspaces": {
    "hoist": true
  }
  

  注意：如果依赖存在peer依赖冲突，强行hoist可能导致项目报错，需要先做测试验证。
• 替换CRA（进阶方案）：如果想实现全仓依赖统一管控，可以放弃CRA，手动配置webpack/vite等构建工具，将所有构建相关依赖移到根目录，彻底消除子项目的专属构建依赖。

内容的提问来源于stack exchange，提问作者Тимур