新手刚开始使用vue时,常会遇见一个坑,那就是热替换失效。
什么?你跟我说使用官方的vue-cli去构建,我就是使用vue-cli后突然失效。
什么?你跟我说重新npm run dev一下,好嘛,已经run了N次了依然没回到大路上。
经过在网上一番查找,发现基本没有这个问题的详解,可能是这个问题太低级了?
讲解一下热替换的原理:
热替换是在执行npm run dev后,会启动一个本地服务器(webpack-dev-server),这个服务器会观察源代码编译出来的文件。一旦修改了源代码,就会立刻编译源代码,然后观察新编译后的文件,接下来替换。
为什么会有编译这个过程,就是因为使用.vue开发时,浏览器不认识这种类型的文件,需要将.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的值 改为 "./"
网友评论