# vue-cli3脚手架的搭建

原文地址 (opens new window)

安装vue-cli3之前需要Node.js8.9或更高版本,没有安装的可以参考https://immortalszz.github.io/soft/nvm.html (opens new window) 。

# 前言

在八月份的时候vue-cli已经更新到了3.X，新版本的脚手架，功能灰常强大，试用过后非常喜欢，写篇教程来帮助各位踩下坑。

# 主要内容

零配置启动/打包一个.vue文件
详细的搭建过程
重点推荐：使用图形化界面创建/管理/运行项目

# 安装

# 卸载vue-cli低版本

如果你事先已经全局安装了旧版本的vue-cli(1.x 或 2.x),你需要先卸载它:

npm uninstall vue-cli -g

# 安装vue-cli3

npm install -g @vue/cli // 安装cli3.x
vue --version // 查询版本是否为3.x

1
2

如果cli3.x用的不舒服，cli3也能使用2.x模板：

npm install -g @vue/cli-init // 安装这个模块
// 就可以使用2.x的模板：vue init webpack my-project

1
2

# 零配置启动/打包一个.vue文件

npm install -g @vue/cli-service-global

安装完扩展之后，可以随便找个文件夹建一个如下方示例的.vue文件,然后跑起来

vue serve App.vue // 启动服务
vue build App.vue // 打包出生产环境的包并用来部署

1
2

如图所示，服务启动的时候回生成一个node_modules包，稍微测试了一下，服务支持ES6语法和热更新，打包的时候会生成一个dist文件夹。(新建一个test.vue文件也只有一个node_modules/dist文件夹)

# 创建项目

1. 命令行

vue create hello-cli3

hello-cli3是文件夹名字，如果不存在会自动创建文件夹，如果存在会安装到那个文件夹中。
相比2.x的时候需要自己手动创建一个文件夹，这里也算是一个小优化吧。

2. 选择模板

一开始只有两个选项: default(默认配置)和Manually select features(手动配置) 默认配置只有babel和eslint其他的都要自己另外再配置，所以我们选Manually select features第二项手动配置。
在每次选择手动配置完成之后，会询问你是否保存配置，也就是图片中的koro选项，这样以后我们在进行创建项目的时候只需使用之前使用的配置就可以了，而不用再重新进行配置。

3. 选择配置

根据你的项目需要来选择配置,空格键是选中与取消，A键是全选

? Check the features needed for your project: (Press space to select, to toggle all, to invert selection)
// 检查项目所需的功能:(按space选择，切换所有，反转选择）

4. 选择css预处理器

如果你选择了Css预处理器选项，会让你选择这个

? Pick a CSS pre-processor (PostCSS, Autoprefixer and CSS Modules are supported by default):
// 选择CSS预处理器（默认支持PostCSS，Autoprefixer和CSS模块）：

5. 是否使用路由的history模式

这里我建议选No，这样打包出来丢到服务器上可以直接使用了，后期要用的话，也可以自己再开起来。
选yes的话需要服务器那边再进行设置。
Use history mode for router? (Requires proper server setup for index fallback in production)
// 路由使用history模式?(在生产环境中需要适当的服务器设置以备索引)

6. 选择Eslint代码验证规则

7. 选择什么时候进行代码规则检测

建议选保存就检测，等到commit的时候，问题可能都已经积累很多了。

? Pick additional lint features: (Press space to select, to toggle all, to invert selection)

8. 选择e2e测试

9. 把babel,postcss,eslint这些配置文件放哪

通常我们会选择独立放置In dedicated config files ，让package.json干净些

? Where do you prefer placing config for Babel, PostCSS, ESLint, etc.? (Use arrow keys)

10. 是否保存配置

Save this as a preset for future projects? (Y/n) // 是否记录一下以便下次继续使用这套配置
// 选保存之后，会让你写一个配置的名字：
Save preset as:  name // 然后你下次进入配置可以直接使用你这次的配置了
比如上面的koro

1
2
3
4

11. 安装依赖

进入项目目录打开终端

cnpm install

12. 与cli2的差别

一起来看一下新项目的结构(下图),会发现2.x的webpack配置的目录不见了，也就是没有build、config这两个文件夹了

这种方式的优势还是比较友好，不会一上来就两个文件夹，一堆文件，看着脑袋都大了。
然后在引用抄别人的配置的时候，也非常方便，直接将文件复制过来就好了。
在自定义一下webpack的配置，我们需要在根目录新建一个vue.config.js文件，文件中应该导出一个对象，然后进行配置，详情查阅官方文档 (opens new window)
还有一些小变动像：static文件夹改为public了，router文件夹变成了单个文件之类的

const vuxLoader = require('vux-loader')
module.exports = {
  configureWebpack: config => {
    vuxLoader.merge(config, {
      plugins: ['vux-ui']
    })
    if (process.env.NODE_ENV === 'production') {
      // 为生产环境修改配置...
    } else {
      // 为开发环境修改配置...
    }
  },
  baseUrl: process.env.NODE_ENV === 'production' ? '/online/' : '/',
  // outputDir: 在npm run build时 生成文件的目录 type:string, default:'dist'
  // outputDir: 'dist',
  // pages:{ type:Object,Default:undfind }
  devServer: {
    port: 8888, // 端口号
    host: 'localhost',
    https: false, // https:{type:Boolean}
    open: true, // 配置自动启动浏览器
    proxy: {
      '/api/*': {
        target: 'http://192.168.175.78:981/Server.svc/',
        host: 'http://192.168.175.78:981',
        changeOrigin: true
      }
      // 配置多个代理
    }
  }
}