使用 npm link 进行本地调试的核心做法是建立符号链接，将全局安装的包指向本地开发目录。具体操作是在库项目中运行 npm link 注册链接，然后在依赖该库的项目中再次运行 npm link <package-name></package-name> 完成绑定。这样修改库代码后无需重新发布即可在依赖项目中实时生效。
如何配置库项目以支持链接
在库项目的根目录下执行 npm link 命令，这会在 npm 的全局注册表中创建一个指向当前目录的符号链接。此时，全局环境中的 <package-name></package-name> 实际上指向了你的本地源码路径。确保库项目的 package.json 中定义了正确的 name 字段，因为这是链接时的唯一标识符。
{
"name": "my-local-lib",
"version": "1.0.0",
"main": "dist/index.js",
"scripts": {
"build": "tsc"
}
}上述配置展示了库项目的基本结构。执行 npm link 后，系统会读取 name 字段并建立映射关系。如果 main 字段指向编译后的文件，记得在开发时配合构建脚本使用，或者直接在 main 中指向源码入口以便热更新。
立即学习“Java免费学习笔记（深入）”；
如何在目标项目中应用链接
切换到需要使用该库的目标项目目录，运行 npm link <package-name></package-name>。这一步会将目标项目中的 node_modules/<package-name></package-name> 替换为指向库项目的符号链接。此后，你在库项目中修改代码，目标项目引用该模块时会自动获取最新内容。调试时建议关闭目标项目的 node_modules 缓存或重启进程以确保加载最新状态。
// target-project/index.js
const lib = require('my-local-lib');
console.log(lib.hello());
这段代码演示了目标项目如何引入已链接的库。由于 my-local-lib 已被链接，require 调用实际访问的是本地库的路径。若库项目有 TypeScript 源码，需确保目标项目能正确解析或通过构建工具处理。调试过程中，任何对库源码的保存都会立即反映在目标项目的运行时行为中。
如何处理链接后的类型检查与构建同步
当库项目使用 TypeScript 等需要编译的语言时，直接修改源码可能不会立即生效，因为目标项目引用的是编译后的输出文件。需要在库项目中配置构建脚本，并在每次修改后手动或自动触发构建。例如，可以使用 tsc --watch 保持编译进程运行，确保 dist/ 目录下的文件始终与源码同步。此外，若目标项目也使用 TypeScript，可能需要配置 paths 映射来优化类型检查体验，避免重复安装依赖导致的类型冲突。
