Vue CLI 3.0 快速上手指南:从安装到配置详解

作者:青山有信时间:2026-10-23 04:09:36浏览:339

本文详细介绍 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)测试。

  1. 如果选择了 Vue Router,系统会进一步询问是否启用 History 模式。
  2. 若选择了 CSS 预处理器,用户需指定具体使用的预处理器类型,如 Less、SCSS 或 Stylus。
  3. ESLint 配置中还有几项需要注意。
    1. 仅用于防止出错。
    2. Airbnb 配置
    3. 标准配置
    4. ESLint 结合 Prettier。
  4. 此外,还有一个选项是将配置文件(如 Babel、PostCSS、ESLint 等)放置在单独的文件中,还是直接写入 package.json。通常建议放置在单独文件中以保持清晰。
  5. 最后,系统提供保存配置的选项,以便未来快速复用。

项目目录结构与 Webpack 配置

配置完成后,系统将自动安装项目所需的依赖包。

生成的项目目录结构如下所示。

Vue CLI 3.0 简介与安装

与 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//错误
  }
 }


}

其他实用功能

其他

  1. 可以使用 vue serve 和 vue build 命令对单个 Vue 文件进行快速开发和构建。
  2. 此外,还可以通过 vue ui 提供的图形化界面来创建和管理项目。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持本站。

作者最新文章