lerna多包项目中子模块引用靠symlink+依赖图谱+bootstrap实现：需在package.json用semver声明依赖，运行lerna bootstrap --use-symlinks建立链接，避免混用npm link，并配置webpack适配symlink路径。
在 Lerna 管理的多包项目中，子模块相互引用不是靠手动改 package.json 或反复 npm publish/link 解决的，核心是靠 符号链接（symlink）+ 依赖图谱识别 + 正确的 bootstrap 流程。只要配置和操作到位，引用关系能自动建立、本地调试畅通、构建也能按需处理。
依赖声明必须写对，且仅声明真实依赖
子包 A 要使用子包 B，必须在 A 的 package.json 的 dependencies（或 devDependencies）里显式写入："@org/b": "^1.0.0"
这个版本号不一定要精确匹配当前本地 B 的版本，Lerna 后续会自动对齐。但不能写成：
❌ "@org/b": "link:../b"（非标准写法，破坏可移植性）
❌ "@org/b": "file:../b"（绕过 Lerna 管理，无法参与版本联动）
✅ 必须用规范的 semver 格式，哪怕暂时是占位符（如 "^0.0.0"），Lerna 才能识别这是内部依赖。
运行 lerna bootstrap --use-symlinks 建立本地链接
这条命令是关键动作，它会：
- 为每个包安装自己的
node_modules（含三方依赖） - 扫描所有
dependencies中匹配packages/**/package.json的包名（比如@org/b） - 在 A 的
node_modules/@org/b下创建指向../b源码目录的 symlink - 确保所有跨包 import/require 能直接解析到源码，而非已发布的 dist 版本
⚠️ 注意：不要混用 npm link。一旦你对某个包执行了 npm link @org/b，再跑 lerna bootstrap，Node 可能加载两个不同路径下的 @org/b 实例，导致 React Hook 报错、单例失效等问题。
Webpack / 构建工具需适配 symlink 路径
Webpack 默认按“真实文件路径”解析 loader 配置（比如 babel-loader 的 include）。而 symlink 后，A 引用 B 的源码时，真实路径是 /path/to/my-monorepo/packages/b/src/...，但你希望它走 A 的 babel 配置（因为 B 是作为 A 的依赖被编译的）。
解决办法是显式扩展 loader 的作用范围：
- 在 Webpack 配置中把
include改为包含整个packages目录：include: [path.resolve(__dirname, 'src'), path.resolve(__dirname, '../packages')] - 或使用
resolve.symlinks = false（慎用，可能影响其他功能） - 更推荐方式：在 B 包自身提供
dist入口（如main/module字段），让 A 在生产构建时引用编译后产物，开发时仍用 symlink 调试源码
发布时依赖版本要自动对齐
尤其在 independent 模式下，B 升级到 v2.1.0 后，A 的 package.json 不会自动更新 "@org/b": "^1.0.0" → "^2.1.0"，除非你启用依赖重写机制：
- 确保
lerna.json中开启："command": { "version": { "conventionalCommits": true } } - 提交时使用规范格式（如
feat(b): add new util），触发 Lerna 自动识别变更并更新依赖方的版本字段 - 或手动运行：
lerna updated --all查看哪些包受影响lerna exec --since -- npm install更新依赖并重装
这样既能保持各包独立演进，又避免“引用旧版却以为用了新版”的隐性 bug。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
