Vue-项目从本地搭建到线上部署（wǒ shì biaō tí dǎng）

做者：gauseen

0. 关于 Vuejs

• 简介：Vue (读音 /vjuː/，相似于 view) 是一套用于构建用户界面的渐进式框架，易用、灵活、高效。
• 生态系统

项目	介绍
awesome-vue	Vue.js 相关很棒的工具集
vue-router	Vue.js 官方的路由管理器
vuex	Vue.js 应用的状态管理工具
vue-cli	一键式快速构建 Vue.js 应用开发环境
vue-loader	webpack 的 loader，解析 .vue 文件，它容许你以一种名为单文件组件 (SFCs)的格式撰写 Vue 组件
vue-server-renderer	服务端渲染(ssr)
vue-rx	集成 RxJS (处理事件的工具)
vue-devtools	Vue.js 开发调试工具浏览器插件

1. 开发规范

• JavaScript Standard
• Vue 编码风格规范
• 项目目录规范

2. 建立项目

# 安装 vue cli
yarn global add @vue/cli

# 初始化项目
vue create hello-world-3x

cd hello-world-3x

# 本地运行项目
yarn serve

3. 静态资源

静态资源能够经过两种方式进行处理：

• 在 JavaScript 被导入或在 template/CSS 中经过相对路径被引用。这类引用会被 webpack 处理。
• 放置在 public 目录下或经过绝对路径被引用。这类资源将会直接被拷贝，而不会通过 webpack 的处理。

• URL 转换规则

  • 若是 URL 是一个绝对路径 (例如 /images/foo.png)，它将会被保留不变。
  • 若是 URL 以 . 开头，它会做为一个相对模块请求被解释且基于你的文件系统中的目录结构进行解析。
  • 若是 URL 以 ~ 开头，其后的任何内容都会做为一个模块请求被解析。这意味着你甚至能够引用 Node 模块中的资源：
  • 若是 URL 以 @ 开头，它也会做为一个模块请求被解析。它的用处在于 Vue CLI 默认会设置一个指向 <projectRoot>/src 的别名 @

4. public 文件夹

• 任何放置在 public 文件夹的静态资源都会被复制到 outputDir 对应值的目录下（默认 'dist'）。
• 若是用绝对路径来引用，不会被 webpack 处理(资源只存在 1 份)；
• 若是用相对路径来引用，会被 webpack 处理，将图片从新打包到 <outputDir>/<assetsDir>/img/ 目录下，并给图片加 hash 值，以便更好的控制缓存。资源会存在 2 份(还有第一条复制的 1 份)
• 因此引用 public 文件夹的静态资源建议使用绝对路径，注意配置路径 publicPath 前缀

<img :src="`${publicPath}logo.png`">

data () {
  return {
    publicPath: process.env.BASE_URL,
  }
},

5. vue.config.js

<font style="color: #ff9966;">
注：有些 webpack 选项是基于 vue.config.js 中的值设置的，因此不能直接修改。如：你应该修改 vue.config.js 中的 publicPath 选项而不是修改 output.publicPath
</font>

• publicPath(同 baseUrl, vue cli 3.3 弃用)

  做用：设置全部通过 webpack 处理的静态资源路径前缀（不包括用绝对路径引用的资源）

  默认：'/'

  默认状况下，Vue CLI 会假设你的应用是被部署在一个域名的根路径上，如：https://domain.com，publicPath 不须要刻意设置。
  若是应用被部署在一个子路径上，你就须要用这个选项指定这个子路径，如：https://domain.com/my-app/，那么 publicPath 为 /my-app/。

• webpack 配置
  vue cli 内部配置，是经过 webpack-chain 维护的，使 webpack 的配置在后期修改起来更方便、简单。

  对于 CSS 相关 loader 来讲，咱们推荐使用 css.loaderOptions 而不是直接链式指定 loader。这是由于每种 CSS 文件类型都有多个规则，而 css.loaderOptions 能够确保你经过一个地方影响全部的规则

// vue.config.js

// CSS loader 相关配置
css: {
  loaderOptions: {
    stylus: {},
  },
},

// webpack 其它配置
chainWebpack: config => {
    // 配置别名
    config.resolve.alias
      .set('rootDir', path.join(__dirname))
    config.module
    // 添加一个具名规则 方便后期修改
      .rule('compile')
        .test(/\.js$/)
        .include
          .add('src')
          .end()
        // 甚至能够建立具名 loader，方便后期修改
        .use('babel')
        .loader('babel-loader')
        .options({
          presets: [
            ['@babel/preset-env', { modules: false }]
          ]
        })

    // 修改具名 loader
    config.module
      .rule('compile')
        .use('babel')
          .tap(options => newOptions)

6. webpack 配置检查

vue inspect > output.js # 输出开发模式下 webpack 配置信息
vue inspect --mode production > output.js # 输出生产模式下 webpack 配置信息

7. 支持多环境模式打包

场景：有 development、test、preview、production 多种线上环境，每一个环境用到的变量值都不一样，该怎么用程序解决？

vue-cli 3.x 支持多种环境模式变量配置

.env                # 在全部的环境中被载入
.env.local          # 在全部的环境中被载入，但会被 git 忽略
.env.[mode]         # 只在指定的模式中被载入
.env.[mode].local   # 只在指定的模式中被载入，但会被 git 忽略

环境变量优先级：环境变量的文件名 . 越多优先级越高。如：.env.production > .env

默认状况下 vue-cli 3.x 只支持 3 种模式，分别为:

• development 模式用于 vue-cli-service serve
• production 模式用于 vue-cli-service build
• test 模式用于 vue-cli-service test:unit 和 vue-cli-service test:e2e

那如何新加模式呢？

能够经过传递 --mode 选项参数为命令行 vue-cli-service 指定具体环境模式。如：新加 preview 模式

• 项目根目录新增 .env.preview 文件，由于每一个模式默认都会将 NODE_ENV 的值设置为模式的名称，因此要添加 NODE_ENV=production 变量(preview 模式也是须要打包上传服务器的)。

• package.json scripts 文件新增脚本命令

  "build:preview": "vue-cli-service build --mode preview"

• 运行 yarn build:preview 打包编译便可

8. mock 数据之 api 接口管理工具

先后端分离式开发已经很常见了，为了先后端并行开发，mock 数据(造假数据) 已是个不可避免的问题。 对前端来讲 mock 数据的方式有不少种：

• Mock.js 模拟数据生成器

  • 须要前端手动去写 mock 数据代码，比较麻烦
  • 每一个项目都要有一套 mock 代码，复用率底
  • 没有 GUI 可视化界面，不方便后端开发查看接口、字段等 api 信息

• easy-mock 是一个可视化，而且能快速生成模拟数据的持久化服务

  • 支持可视化界面
  • 支持协同编辑
  • 支持 swagger，可基于 swagger 快速建立项目接口
  • 支持 Mock.js 语法
  • 支持接口预览，等等
  • 免费开源，私有化部署简单

• RAP 和 RAP2 阿里妈妈出品，开源接口管理工具 RAP 第一代和二代

  • 支持可视化界面
  • 支持协同编辑
  • 支持 Mock.js 语法
  • 不支持 swagger 数据导入，但支持 JSON 格式数据的导入导出
  • 免费开源，但私有化部署相对繁琐

• YApi 是一个可本地部署的、打通先后端及 QA 的、可视化的接口管理平台

  • 支持可视化界面
  • 支持协同编辑
  • 支持自动化测试, 对 Response 断言
  • 基于 Json5 和 Mockjs 定义接口返回数据的结构和文档
  • 支持 swagger、postman、json、har 数据导入
  • 免费开源，私有化部署简单

9. vue 项目中使用 api 接口管理平台

// vue.config.js

// 基础地址
const baseApi = '/api'
// YApi 项目 ID (YApi 建立项目所得)
const mockProjectId = '66666'

module.exports = {
  // 代理
  devServer: {
    proxy: {
      // 开发环境代理
      [`${baseApi}/(?!mock)`]: {
        target: process.env.VUE_APP_DOMAIN || 'http://test.domain.com', // 测试环境
        changeOrigin: true,
      },
      // mock 数据代理
      [`${baseApi}/mock`]: {
        target: 'http://yapi.demo.qunar.com',
        changeOrigin: true,
        pathRewrite: {
          [`${baseApi}/mock`]: `/mock/${mockProjectId}${baseApi}`,
        },
      },
    },
  },
}

10. 本地预览打包代码

http-server 是一个基于 node，零配置命令行 http 服务器。

# 安装
yarn add -D http-server

# 配置 package.json scripts
"scripts": {
  "preview": "http-server ./ -P",
},

# 打包产出
yarn build

# 修改文件名 dist/ ===> my-app/(与 publicPath 保持一致)
mv -rf dist/ my-app/

# 本地预览(http://ip:port 可选, 为代理服务)
yarn preview <http://ip:port>

# 浏览器打开链接访问便可

11. 线上部署

这里主要讲述先后端分离式线上部署

当前应用路由模式分2种，hash 和 history 模式

• hash 模式

  • 样式比较丑，不太符合人的 “审美”
  • 浏览器地址栏 URL 有 # (如：http://localhost:3000/#/a)
  • # 后面的内容不会传给服务端
  • 改变浏览器地址栏 URL # 后面的值，不会引发网页重载

• history 模式

  • HTML5 新特性，样式比较优雅
  • 浏览器地址没有 # (如：http://localhost:3000/a)
  • 没有 # ，全部 domain 后面的内容都会传给服务端
  • 改变浏览器地址栏 URL 会网页重载，再次请求服务器，并向 history 栈中插入一条记录

具体区别看这里

• web 服务器

前端页面须要跑在 web 服务器里面，主要包括 Nginx，Apache，IIS 等，主要处理一些静态资源。咱们公司使用 Nginx，下面介绍前端应用部署时 Nginx 的一些配置：

• hash 模式配置

location ^~ /pos2/
{
  root /data/www/webproject;
  index  index.html index.htm;
}

• history 模式配置

location ^~ /crmwap/
{
  root /data/www/webproject;
  try_files $uri $uri/ /crmwap/index.html =404;

  # 已知: $document_root = root = /data/www/webproject

  # 若: try_files $uri $uri/ /crmwap/index.html =404; fall back 以下:
  # $document_root$uri --> $document_root$uri/ -->  $document_root/crmwap/index.html --> nginx 404

  # 若：try_files $uri $uri/ /crmwap/index.html; fall back 以下:
  # $document_root$uri --> $document_root$uri/ --> http://domain.com/crmwap/index.html
}

Nginx 经常使用命令

# 启动
start nginx

# 重启
nginx -s reload

# 关闭
nginx -s stop

注：try_files 的最后一个位置（fall back）是特殊的（仅限 root），它会发出一个内部 “子请求” 而非直接在文件系统里查找这个文件。
在不更改 Nginx 配置文件的状况下，前端页面迭代发布，不须要重启 Nginx 服务。

12. 自动化构建工具

• Jenkins

欢迎关注公众号: 学前端