npm link 实现本地包联调需确保各包有合法 package.json（含唯一 name 和 main 字段），依次执行 npm link 注册全局，再在主项目中 npm link 依赖包以创建软链接；复杂场景推荐改用 npm workspaces 统一管理。
在 JavaScript 项目中，用 npm link 实现多个本地包之间的联调，核心是让它们彼此“看得见、连得上、实时同步”。不需要发布，也不依赖网络，改完保存就能在下游项目里立刻生效。
确保每个包都有合法的 package.json
每个待联调的包（比如 @myorg/utils、@myorg/api-client、my-app）都必须有正确的 name 和 main 字段：
-
name必须唯一，作用域包要带@scope/前缀，例如"name": "@myorg/utils" -
main指向入口文件，如"main": "dist/index.js"（若用 TypeScript 或构建流程，先npm run build生成dist） - 如果包含二进制命令（CLI），还需配置
bin字段
逐个建立全局链接
进入每个包的根目录，依次执行 npm link：
-
cd packages/utils && npm link→ 全局注册@myorg/utils -
cd packages/api-client && npm link→ 全局注册@myorg/api-client - 注意：顺序不强制，但建议从被依赖方开始
此时这些包已出现在全局 node_modules 中（路径可通过 npm prefix -g 查看），只是“挂在那里”，还没被谁引用。
在主项目中按需链接依赖
进入你的应用或测试项目（如 my-app），执行对应链接命令：
-
npm link @myorg/utils @myorg/api-client（一次链多个） - 或分步：
npm link @myorg/utils，再npm link @myorg/api-client - 完成后，
my-app/node_modules下会出现两个软链接，分别指向你本地的源码目录 - 验证方式：
npm ls @myorg/utils应显示link <your-local-path></your-local-path>
处理循环依赖与工作区替代方案
当包数量变多、依赖关系复杂时，npm link 容易出错（比如版本冲突、链接失效、清理困难）：
- 避免手动反复
npm unlink，推荐用npm link --no-save（默认行为，不写入package.json） - 更稳妥的方式是迁移到
npm workspaces：在根package.json中声明"workspaces": ["packages/*"]，然后统一npm install，所有包自动符号链接且版本一致 - workspaces 不仅省去
link步骤，还支持npm run build --workspace=utils等定向操作，适合长期协作
