Vue CLI 3.0 快速上手指南:从安装到配置详解
本文详细介绍 Vue CLI 3.0 的安装与使用。涵盖基于 Webpack 4 的项目初始化流程,包括默认与自定义插件选择(如 Router、Vuex、Linter)。重点解析项目目录结构变化,以及如何通过 vue.config.js 进行 Webpack 高级配置,包括插件、Loader 及开发服务器设置,助力开发者高效构建 Vue 应用。
Vue CLI 3.0 简介与安装
近期,Vue 作者尤雨溪正式发布了 Vue CLI 3.0 版本。该版本底层基于 Webpack 4 构建,建议开发者尽快进行尝试和体验。
官方文档地址为 vue-cli。
简介
Vue CLI 是一套专为 Vue.js 应用设计的完整快速开发系统,旨在简化项目搭建流程。
项目创建与配置流程
使用
<!-- 安装 -->
npm install -g @vue/cli
<!-- 创建项目 -->
npm create new-cli
接下来进入配置环节,用户可以选择保持默认配置(包含 Babel 和 ESLint),或者选择自定义配置。
若选择自定义配置,可选模块包括 Babel、TypeScript、PWA、Vue Router、Vuex、CSS 预处理器以及 Linter/Formatter。此外,还支持单元测试和端到端(e2e)测试。
- 如果选择了 Vue Router,系统会进一步询问是否启用 History 模式。
- 若选择了 CSS 预处理器,用户需指定具体使用的预处理器类型,如 Less、SCSS 或 Stylus。
- ESLint 配置中还有几项需要注意。
- 仅用于防止出错。
- Airbnb 配置
- 标准配置
- ESLint 结合 Prettier。
- 此外,还有一个选项是将配置文件(如 Babel、PostCSS、ESLint 等)放置在单独的文件中,还是直接写入 package.json。通常建议放置在单独文件中以保持清晰。
- 最后,系统提供保存配置的选项,以便未来快速复用。
项目目录结构与 Webpack 配置
配置完成后,系统将自动安装项目所需的依赖包。
生成的项目目录结构如下所示。

与 CLI 2 版本不同,新版项目不再包含 build 和 config 目录,而是引入了 babel.config.js 等配置文件。
官网建议新建 vue.config.js 文件来进行相关的 Webpack 配置,例如:
// vue.config.js
module.exports = {
configureWebpack: {
plugins: [
new MyAwesomeWebpackPlugin()
]
},
//loader
chainWebpack: config => {
config.module
.rule('vue')
.use('vue-loader')
.loader('vue-loader')
.tap(options => {
// 修改它的选项...loader
return options
})
},
//生产环境关闭map
productionSourceMap:false,
//基本URL
baseUrl: process.env.NODE_ENV === 'production'
? 'http://www.baidu.com'
: 'https://www.google.com',
outputDir:'dist', //build 目录
assetsDir:'',//asset目录
indexPath:'index.html',//指定index.html 路径
filenameHashing:true,//文件名带hash
// multi-page模式,每个“page”应该有一个对应的 JavaScript 入口文件
pages: {
index: {
// page 的入口
entry: 'src/index/main.js',
// 模板来源
template: 'public/index.html',
// 在 dist/index.html 的输出
filename: 'index.html',
// 当使用 title 选项时,
// template 中的 title 标签需要是 <title><%= htmlWebpackPlugin.options.title %></title>
title: 'Index Page',
// 在这个页面中包含的块,默认情况下会包含
// 提取出来的通用 chunk 和 vendor chunk。
chunks: ['chunk-vendors', 'chunk-common', 'index']
},
// 当使用只有入口的字符串格式时,
// 模板会被推导为 `public/subpage.html`
// 并且如果找不到的话,就回退到 `public/index.html`。
// 输出文件名会被推导为 `subpage.html`。
subpage: 'src/subpage/main.js'
},
//css配置
css: {
sourceMap:false,//css source map
loaderOptions: {
css: {
// 这里的选项会传递给 css-loader
},
postcss: {
// 这里的选项会传递给 postcss-loader
}
}
},
//dev server
devServer: {
host:127.0.0.1
port:8000,
proxy: 'http://localhost:4000',
overlay: {
warnings: true,//警告
errors: true//错误
}
}
}
其他实用功能
其他
- 可以使用 vue serve 和 vue build 命令对单个 Vue 文件进行快速开发和构建。
- 此外,还可以通过 vue ui 提供的图形化界面来创建和管理项目。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持本站。
Vue 3 核心变化解析:Composition API 与响应式系统详解
2026-11-03 21:33:38
viewer.js v1 升级到 v2 需要注意哪些 API 变更
2026-11-03 20:42:00
Vue3 与 React 中怎么封装 hls.js 播放器组件
2026-11-03 11:13:51
Vue.js官网访问慢或打不开怎么办?国内镜像与GitHub备用方案
2026-11-02 09:19:09
利用Axios实现无感知双Token刷新的详细教程
2026-11-01 03:11:12
