vue/cli3.0脚手架部署到nginx时页面空白问题解决办法

首先,明确一下问题

vue/cli3.0部署到nginx出现页面白屏,不能正常显示网页内容,利用F12,经过初步判断,是路径设置问题。

然后,对比一下2.0与3.0.

先对比一下两个版本脚手架的目录结构

  • 2.0目录结构
    vue/cli3.0脚手架部署到nginx时页面空白问题解决办法
  • 3.0目录结构
    vue/cli3.0脚手架部署到nginx时页面空白问题解决办法

可见,vue-cli3.0与2.0有一个不同之处是3.0脚手架中没有build和config文件,在往nginx中部署2.0时,我们可以通过修改build和config中的路径,就可以成功用nginx访问,但对于3.0来说,其本身没有build文件,所以并不好去修改路径,当然貌似也可以去手动创建以个build文件,在里面进行手动编辑,这样肯定是会比较麻烦的。

我在遇到这个问题的时候,在网上搜集了很多办法,大多数都是以修改2.0的build文件中的路径为主。

后来终于找到一种解决办法,而且只加了一行代码.

正文,解决办法就是在vue.config.js文件中加一个基本路径

baseUrl: './',

首先,这句话的意思就是让打包后(npm run build )的index.html去找相对路径下的css和js文件。

一般而言,打包后的文件都在dist文件下,index.html与js和css处于同一级目录下,这样设置路径之后就会使得index直接去同级目录下去检索.

而在不这样设置的情况下,会默认去读取绝对根目录下的文件,css和js一般不在根目录下,而是与index.html同级,找不到样式便不能加载页面样式,这也是出现空白的原因所在

回过头,再看看3.0的文件夹结构

3.0的脚手架,虽然没有了2.0的build和config文件,却有了一个vue.config.js文件,利用这个文件,很多的东西都在这里可以配置,其实进一步提升了在vue脚手架中的配置设置。

那么,怎么写这个文件呢?

附一下vue.config.js的文件语法:

module.exports = {
 // 基本路径
 baseUrl: '/',
 // 输出文件目录
 outputDir: 'dist',
 // eslint-loader 是否在保存的时候检查
 lintOnSave: true,
 // use the full build with in-browser compiler?
 // https://vuejs.org/v2/guide/installation.html#Runtime-Compiler-vs-Runtime-only
 compiler: false,
 // webpack配置
 // see https://github.com/vuejs/vue-cli/blob/dev/docs/webpack.md
 chainWebpack: () => {},
 configureWebpack: () => {},
 // vue-loader 配置项
 // https://vue-loader.vuejs.org/en/options.html
 vueLoader: {},
 // 生产环境是否生成 sourceMap 文件
 productionSourceMap: true,
 // css相关配置
 css: {
  // 是否使用css分离插件 ExtractTextPlugin
  extract: true,
  // 开启 CSS source maps?
  sourceMap: false,
  // css预设器配置项
  loaderOptions: {},
  // 启用 CSS modules for all css / pre-processor files.
  modules: false
 },
 // use thread-loader for babel & TS in production build
 // enabled by default if the machine has more than 1 cores
 parallel: require('os').cpus().length > 1,
 // 是否启用dll
 // See https://github.com/vuejs/vue-cli/blob/dev/docs/cli-service.md#dll-mode
 dll: false,
 // PWA 插件相关配置
 // see https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-pwa
 pwa: {},
 // webpack-dev-server 相关配置
 devServer: {
  open: process.platform === 'darwin',
  host: '0.0.0.0',
  port: 8080,
  https: false,
  hotOnly: false,
  proxy: null, // 设置代理
  before: app => {}
 },
 // 第三方插件配置
 pluginOptions: {
  // ...
 }
}
 

贴一张我在项目中的用例:
这是可以成功部署到nginx中的项目配置写法,其中用到了基本路径和后台代理等相关配置。
vue/cli3.0脚手架部署到nginx时页面空白问题解决办法