UniApp项目中热更新监听node_modules文件变化的解决方案

背景介绍

在UniApp开发过程中，使用Monorepo工程结构时，开发者经常会遇到一个棘手问题：热更新(HMR)无法正常监听node_modules目录下文件的变化。这个问题尤其在使用pnpm等现代包管理工具时更为常见，因为Monorepo架构下很多依赖都是以符号链接形式存在于node_modules中。

问题本质

Vite作为UniApp的底层构建工具，默认会忽略node_modules目录的文件变化监听，这是出于性能考虑的设计选择。但在Monorepo场景下，我们经常需要修改本地开发的依赖包，这时就需要突破这个限制。

解决方案

方法一：修改vite配置

在vite.config.js中，可以通过server.watch配置项来调整文件监听行为：

export default defineConfig({
  server: {
    watch: {
      // 包含需要监听的node_modules路径
      ignored: [
        '!**/node_modules/your-package-name/**',
      ]
    }
  }
})

方法二：使用软链接替代

对于Monorepo中的本地包，可以尝试以下方法：

1. 在项目根目录创建links目录
2. 使用pnpm link或npm link将需要开发的包链接到项目
3. 确保链接后的路径在vite的监听范围内

方法三：调整包管理器配置

对于pnpm用户，可以尝试修改.npmrc配置：

node-linker=hoisted

这会将依赖提升到顶层node_modules，可能改善文件监听效果。

注意事项

1. 过度监听node_modules可能影响开发服务器的性能
2. 在Monorepo中，确保工作区依赖的版本号使用workspace:*协议
3. 如果遇到重复打包问题，检查vite的optimizeDeps配置

最佳实践

对于UniApp项目，推荐以下开发流程：

1. 核心业务代码放在主项目src目录
2. 公共组件和工具库作为独立包放在packages目录
3. 开发时使用workspace:*版本协议
4. 为需要热更新的包单独配置vite监听规则
5. 生产构建时使用固定版本号替代workspace协议

通过合理配置，可以在保持开发体验的同时，确保UniApp项目的热更新功能正常工作。