vue热替换失效根本原因

最新推荐文章于 2025-07-17 11:25:27 发布

原创最新推荐文章于 2025-07-17 11:25:27 发布 · 3.2w 阅读

20 ·

CC 4.0 BY-SA版权

Vue.js 专栏收录该内容

21 篇文章

订阅专栏

新手刚开始使用vue时，常会遇见一个坑，那就是热替换失效。

什么？你跟我说使用官方的vue-cli去构建，我就是使用vue-cli后突然失效。

什么?你跟我说重新npm run dev一下，好嘛，已经run了N次了依然没回到大路上。

经过在网上一番查找，发现基本没有这个问题的详解，可能是这个问题太低级了？

讲解一下热替换的原理：热替换是在执行npm run dev后，会启动一个本地服务器（webpack-dev-server），这个服务器会观察源代码编译出来的文件。一旦修改了源代码，就会立刻编译源代码，然后观察新编译后的文件，接下来替换。

为什么会有编译这个以过程，就是因为使用.vue开发时，浏览器不认识这种类型的文件，需要编译成js文件。

所以整个过程可以这样描述：

源代码 ---> 编译为目标代码(浏览器可以识别运行的代码) ---> 本地服务器观察目标代码 ----> 本地服务器接收到目标代码改变[事件] ----> 刷新浏览器

-------------------------------------------------------------------------------------------------------------------------

常见热替换失效导致的原因:

1.观察文件位置错误

{


  env: require('./dev.env'),
  port: 8080,
  autoOpenBrowser: true,
  assetsSubDirectory: 'static',//必须
  assetsPublicPath: '/',

失效是为什么？是因为修改了源代码后，依然会立刻编译，但是通常被观察的新编译的文件位置错了。也就是说浏览器显示的东西与服务器观察的东西是一个位置，而编译出来文件是另外的位置。

解决办法是：config/index.js中 dev的这个参数必须为static

2.项目目录包含特殊字符

像这样的路径 D:\（myworkspace）\vue-answer-project

这种目录中有一个括号！！！就有可能在浏览器中打开后，发现console报错

http://localhost:8080/__webpack_hmr net::ERR_INCOMPLETE_CHUNKED_ENCODING

这是什么意思呢？就是热替换模块报错，中断了观察页面与热替换模块的链接，无法收到事件。

解决办法就是：去掉这样的路径

3.npm run build后，打开浏览器一片空白

这个位置是根据文件webpack.config.js中的publicPath进行指定的。也就是服务器观察位置是 publicPath: "XX/build.js"这里面的 /XX/build.js这个文件，这个文件需要你在文件 index.html中正确引入。

// webpack编译输出的发布路径
// => 将 build 的路径前缀修改为 ' ./ '（原本为 ' / '），是因为打包(npm run build)之后，
// 外部引入 js 和 css 文件时，如果路径以 ' / ' 开头，在本地是无法找到对应文件的（服务器上没问题）

module.exports = {
  build: {
    env: require('./prod.env'),
    index: path.resolve(__dirname, '../dist/index.html'),
    assetsRoot: path.resolve(__dirname, '../dist'),
    assetsSubDirectory: 'static',
    assetsPublicPath: './',
    productionSourceMap: true,
    // Gzip off by default as many popular static hosts such as
    // Surge or Netlify already gzip all static assets for you.
    // Before setting to `true`, make sure to:
    // npm install --save-dev compression-webpack-plugin
    productionGzip: false,
    productionGzipExtensions: ['js', 'css'],
    // Run the build command with an extra argument to
    // View the bundle analyzer report after build finishes:
    // `npm run build --report`
    // Set to `true` or `false` to always turn it on or off
    bundleAnalyzerReport: process.env.npm_config_report
  },
  dev: {
    env: require('./dev.env'),
    port: 8081,
    autoOpenBrowser: true,
    assetsSubDirectory: 'static',
    assetsPublicPath: '/',
    proxyTable: {},
    // CSS Sourcemaps off by default because relative paths are "buggy"
    // with this option, according to the CSS-Loader README
    // (https://github.com/webpack/css-loader#sourcemaps)
    // In our experience, they generally work as expected,
    // just be aware of this issue when enabling this option.
    cssSourceMap: true
  }