npm link 生效异常：本地Node模块已更新但dev环境未加载最新代码

我之前也碰到过一模一样的坑！结合自己的踩坑经验，以下几个原因大概率能解释你的状况，你可以逐一排查：

• 模块构建产物未同步更新
  很多自研Node模块都会有构建流程（比如TypeScript编译、打包等），业务项目实际加载的是模块package.json中main/module字段指定的构建产物（比如dist/index.js），而不是你直接修改的/src源码。如果只改了源码但没重新构建，dev服务自然还是读旧的产物文件。
  解决：回到自研模块目录，执行npm run build重新生成产物，再重启业务项目的dev服务。

• 开发服务器的缓存干扰
  Vite、Webpack这类开发服务器默认会对node_modules里的模块做缓存优化，即使symlink指向的文件已经更新，服务器可能没检测到变化，依然使用缓存的旧版本。
  解决：

  • 最简单的方式：直接重启dev服务，强制清空缓存
  • 针对性配置：比如Vite可以在vite.config.js中添加optimizeDeps.exclude: ['@account/api']，让服务器不对这个模块做预缓存；Webpack可以调整cache配置或在watchOptions里开启对symlink文件的监听。

• npm link的符号链接异常
  有时候目录结构嵌套、模块自身依赖其他本地模块，会导致symlink的解析路径出现问题——看起来/src有更新，但实际服务加载的是旧的模块副本。
  解决：先在业务项目执行npm unlink @account/api解除链接，回到自研模块目录重新执行npm link，再回到业务项目执行npm link @account/api，确保链接路径正确。

• 业务项目的模块解析规则冲突
  如果你的业务项目配置了模块别名（比如Webpack/Vite的resolve.alias），可能把@account/api指向了某个固定的本地路径，覆盖了symlink的指向，导致加载的不是最新链接的模块。
  解决：检查项目的构建配置文件，确认别名规则没有干扰@account/api的正常解析。

• 模块package.json的配置遗漏
  虽然你看到/src目录有更新，但如果模块的files字段没有包含/src或者构建产物目录，可能导致npm link时没有同步最新文件（不过这个情况少见，因为symlink是指向整个模块目录的）。另外，如果是TypeScript项目，types字段指向的声明文件没更新，也可能导致类型提示异常，但运行时用旧代码主要还是构建产物的问题。

内容的提问来源于stack exchange，提问作者hounan