欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

解决vue热替换失效的根本原因

程序员文章站 2023-11-27 10:14:52
新手刚开始使用vue时,常会遇见一个坑,那就是热替换失效。 什么?你跟我说使用官方的vue-cli去构建,我就是使用vue-cli后突然失效。 什么?你跟我说重新npm...

新手刚开始使用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
 }

解决办法是:在上图中的build.assetspublicpath的值 改为 "./"

以上这篇解决vue热替换失效的根本原因就是小编分享给大家的全部内容了,希望能给大家一个参考,也希望大家多多支持。