npm link 调试多包关联库的核心是确保修改实时生效且引用路径清晰：需严格匹配 package.json 的 name 字段（含作用域）、main/exports 指向已构建的 dist 文件、按依赖层级从底向上分步链接（core→adapter→app），并开启 source map 实现源码级断点调试。
用 npm link 调试多包关联的基础库，核心是让修改实时生效、避免重复构建和安装，同时理清各包之间的引用路径。关键不在“连上”，而在“连得稳、看得清、切得准”。
确保每个包的 name 和入口定义准确
多包调试失败，80% 源于 package.json 配置偏差。必须逐个确认：
-
name 字段严格匹配：作用域包（如
@myorg/utils）必须带完整前缀，npm link @myorg/utils不能简写为npm link utils -
main / exports 字段指向构建后文件：例如
"main": "dist/index.cjs.js"，且该文件需真实存在——若尚未构建，npm link会链接一个空目录，运行时报Cannot find module -
types 字段可选但推荐：若提供 TypeScript 类型，设
"types": "dist/index.d.ts"，编辑器才能正确提示
按依赖层级分步链接，不跳步
假设有三层：基础工具库 @myorg/core → 中间封装库 @myorg/adapter → 最终应用 my-app。链接顺序决定调试是否可靠：
- 先进入
@myorg/core目录，执行npm run build && npm link（先构建再链接） - 再进
@myorg/adapter，执行npm run build && npm link @myorg/core（让它链接已就绪的 core） - 最后进
my-app，执行npm link @myorg/adapter（它会自动解析 adapter 对 core 的依赖，复用已链接的 core）
⚠️ 若反向操作（比如先 link app 再 link adapter），常导致 node_modules 中出现嵌套 symlink 或版本错乱。
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
配合 source map 实现源码级断点调试
链接成功后仍看到编译后大文件？说明构建没输出 source map 或未启用：
- 在基础库的构建配置中（如 Rollup/Vite），确保开启
build.sourcemap: true或output.sourcemap: true - 构建后检查
dist/下是否有.js.map文件，并确认.js文件末尾包含//# sourceMappingURL=xxx.map - 浏览器 DevTools 中，打开
Sources → Filesystem，添加你的本地包根目录，即可映射到原始src/文件并打断点
快速清理与状态验证
调试中途出错，别猜，直接查链路：
- 看全局链接：运行
npm list -g --depth=0，确认你的包名是否出现在列表中 - 看项目内链接：进
my-app/node_modules，执行ls -la | grep myorg，箭头指向的路径应是你本地源码目录 - 一键解除全部：在项目中运行
npm unlink @myorg/adapter && npm install @myorg/adapter；在包目录运行npm unlink
不复杂但容易忽略
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
