如何在webpack 5环境下搭配npm/yarn link正常使用HRM功能?
调整步骤
- 新增webpack5专属
snapshot配置,排除npm link的依赖包路径
webpack5默认将node_modules下的所有文件标记为不可变静态资源,不会监听文件变动,npm link生成的软链也会命中该规则,需要手动排除你需要监听的link包路径:
// webpack.config.js 根配置项添加 snapshot: { managedPaths: [ // 排除你link的包,比如你link的包叫@your/package,就写如下规则 /^(.+?[\\/]node_modules[\\/](?!(@your[\\/]package)))/ ], immutablePaths: [], }
如果有多个link的包,修改正则的负向预查规则,把所有包都加进去即可。
- 修正
resolve和watchOptions配置
把resolve.symlinks调整为true,让webpack正确解析软链到真实磁盘路径,配合watchOptions.followSymlinks: true实现文件变动监听:
resolve: { // 原有其他配置不变 symlinks: true, }, watchOptions: { followSymlinks: true, // 可选:如果监听延迟高可以调整aggregateTimeout aggregateTimeout: 300, }
- 补全devServer配置(如果未配置)
确保devServer开启热更新,同时可以手动指定需要额外监听的link包路径:
devServer: { hot: true, open: true, port: 3001, // 额外监听npm link的包路径 watchFiles: [ 'src/**/*', // 替换为你link的包的真实磁盘路径,比如本地开发的包源码路径 '/Users/xxx/work/your-package/src/**/*' ] }
- 调整babel-loader规则(如果link的包未打包源码)
如果你的npm link包是直接引入源码而非编译后的产物,需要把link包的真实路径加入babel-loader的include规则,避免转译失效:
module: { rules: [ { test: /\.(js|jsx|mjs)$/, include: [ path.resolve(__dirname, 'src'), // 替换为你link的包的真实源码路径 path.resolve(__dirname, '../node_modules/@your/package/src') ], loader: 'babel-loader', } ] }
- 保留现有公共依赖alias配置
你当前配置的react alias可以避免link包和主项目加载多份react实例导致的HRM异常,如果有其他公共依赖(比如react-dom等)也可以按相同规则添加alias。
调整后重启webpack-dev-server即可让HRM正常监听npm link包的代码变动。
内容的提问来源于stack exchange,提问作者nitin katyal
相关产品推荐
相关产品推荐

