# Vue CLI 3 项目构建基础|博客系列

> 本文详细介绍了如何使用 Vue CLI 3 搭建 Vue.js 项目，包括依赖环境准备、脚手架安装、项目创建流程及目录结构解析，适合前端开发者快速上手 Vue 项目构建。

- 原文：https://feinterview.poetries.top/docs/fe-blog-docs/blog-docs/vue/-Vue%20CLI%203%20%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%E5%9F%BA%E7%A1%80
- 来源：前端进阶之旅（feinterview.poetries.top）
- 更新：2025.10.25

---

## 一、依赖工具

```bash
# 查看 node 版本
node -v

# 查看 npm 版本
npm -v
```

## 二、脚手架vue-cli

```bash
# 安装 Vue CLI 3.x
npm i -g @vue/cli
```

> 安装完 `vue-cli` 后，我们在你想要创建的项目目录地址下执行构建命令

```bash
# my-project 是你的项目名称
vue create my-project
```

**目录结构**

```bash
├── node_modules     # 项目依赖包目录
├── public
│   ├── favicon.ico  # ico图标
│   └── index.html   # 首页模板
├── src 
│   ├── assets       # 样式图片目录
│   ├── components   # 组件目录
│   ├── views        # 页面目录
│   ├── App.vue      # 父组件
│   ├── main.js      # 入口文件
│   ├── router.js    # 路由配置文件
│   └── store.js     # vuex状态管理文件
├── .gitignore       # git忽略文件
├── .postcssrc.js    # postcss配置文件
├── babel.config.js  # babel配置文件
├── package.json     # 包管理文件
└── yarn.lock        # yarn依赖信息文件
```

**可视化界面**

> 除了使用上述命令行构建外，`vue-cli 3.x` 还提供了可视化的操作界面，在项目目录下我们运行如下命令开启图形化界面：

```
vue ui
```

![](https://s.poetries.top/gitee/2020/09/75.png)
![](https://s.poetries.top/gitee/2020/09/76.png)

## 三、webpack 在 CLI 3 中的应用

### 3.1 与 vue-cli 2.x 的差异

> 如果你使用过 `vue-cli 2.x`，那么你应该了解其构建出的目录会包含相应的 `webpack `配置文件，但是在 `vue-cli 3.x` 中你却见不到一份关于 webpack 的配置文件，难道 `3.x` 抛弃了 webpack？其实不然，`3.x` 提供了一种开箱即用的模式，即你无需配置 `webpack` 就可以运行项目，并且它提供了一个 `vue.config.js` 文件来满足开发者对其封装的 `webpack` 默认配置的修改

![](https://s.poetries.top/gitee/2020/09/77.png)

### 3.2 vue.config.js 的配置

**a. baseurl**

> 你想要将项目地址加一个二级目录，比如：`http://localhost:8080/vue/`，那么我们需要在 `vue.config.js` 里配置 `baseurl` 这一项

```js
// vue.config.js
module.exports = {
    ...
    
    baseUrl: 'vue',
    
    ...
}
```

> 其改变的其实是 `webpack` 配置文件中 `output` 的 `publicPath` 项，这时候你重启终端再次打开页面的时候我们首页的` url` 就会变成带二级目录的形式。

**b. outputDir**

> 如果你想将构建好的文件打包输出到 `output` 文件夹下（默认是 `dist` 文件夹），你可以配置

```js
// vue.config.js
module.exports = {
    ...
    
    outputDir: 'output',
    
    ...
}
```

> 然后运行命令 `yarn build` 进行打包输出，你会发现项目跟目录会创建 `output` 文件夹， 这其实改变了 `webpack` 配置中 `output` 下的 `path `项，修改了文件的输出路径

**c. productionSourceMap**

> 该配置项用于设置是否为生产环境构建生成 `source map`，一般在生产环境下为了快速定位错误信息，我们都会开启 `source map`：

```js
// vue.config.js
module.exports = {
    ...
    
    productionSourceMap: true,
    
    ...
}
```

> 该配置会修改 `webpack` 中 `devtool` 项的值为 `source-map`

**d. chainWebpack**

> `chainWebpack` 配置项允许我们更细粒度的控制 `webpack `的内部配置，其集成的是 `webpack-chain` 这一插件，该插件可以让我们能够使用链式操作来修改配置，比如

```js
// 用于做相应的合并处理
const merge = require('webpack-merge');

module.exports = {
    ...
    
    // config 参数为已经解析好的 webpack 配置
    chainWebpack: config => {
        config.module
            .rule('images')
            .use('url-loader')
            .tap(options =>
                merge(options, {
                  limit: 5120,
                })
            )
    }
    
    ...
}
```

> 以上操作我们可以成功修改 webpack 中 module 项里配置 rules 规则为图片下的 url-loader 值，将其 limit 限制改为 5M，修改后的 webpack 配置代码如下：

```js
{
    ...
    
    module: {
        rules: [
            {   
                /* config.module.rule('images') */
                test: /\.(png|jpe?g|gif|webp)(\?.*)?$/,
                use: [
                    /* config.module.rule('images').use('url-loader') */
                    {
                        loader: 'url-loader',
                        options: {
                            limit: 5120,
                            name: 'img/[name].[hash:8].[ext]'
                        }
                    }
                ]
            }
        ]
    }
    
    ...
}
```

**e. configureWebpack**

> 除了上述使用 `chainWebpack` 来改变 `webpack` 内部配置外，我们还可以使用 `configureWebpack` 来进行修改，两者的不同点在于 `chainWebpack` 是链式修改，而 `configureWebpack` 更倾向于整体替换和修改。示例代码如下

```js
// vue.config.js
module.exports = {
    ...
    
    // config 参数为已经解析好的 webpack 配置
    configureWebpack: config => {
        // config.plugins = []; // 这样会直接将 plugins 置空
        
        // 使用 return 一个对象会通过 webpack-merge 进行合并，plugins 不会置空
        return {
            plugins: []
        }
    }
    
    ...
}
```

> `configureWebpack` 可以直接是一个对象，也可以是一个函数，如果是对象它会直接使用 `webpack-merge` 对其进行合并处理，如果是函数，你可以直接使用其 `config `参数来修改 `webpack` 中的配置，或者返回一个对象来进行 merge 处理

你可以在项目目录下运行 `vue inspect` 来查看你修改后的 `webpack` 完整配置，当然你也可以缩小审查范围，比如

```bash
# 只查看 plugins 的内容
vue inspect plugins
```

**f. devServer**

> `vue.config.js` 还提供了 `devServer` 项用于配置 `webpack-dev-server` 的行为，使得我们可以对本地服务器进行相应配置，我们在命令行中运行的 `yarn serve` 对应的命令 `vue-cli-service serve` 其实便是基于 `webpack-dev-server` 开启的一个本地服务器，其常用配置参数如下

```js
// vue.config.js
module.exports = {
    ...
    
    devServer: {
        open: true, // 是否自动打开浏览器页面
        host: '0.0.0.0', // 指定使用一个 host。默认是 localhost
        port: 8080, // 端口地址
        https: false, // 使用https提供服务
        proxy: null, // string | Object 代理设置
        
        // 提供在服务器内部的其他中间件之前执行自定义中间件的能力
        before: app => {
          // `app` 是一个 express 实例
        }
    }
    
    ...
}
```

> 当然除了以上参数，其支持所有的 `webpack-dev-server `中的选项，比如 `historyApiFallback` 用于重写路由（会在后续的多页应用配置中讲解）、progress 将运行进度输出到控制台等

### 3.3 默认插件简介

> 通过对 `vue.config.js` 的了解，我们知道了 `vue-cli 3.x `为我们默认封装了项目运行的常用 `webpack` 配置，那么它给我们提供了哪些默认插件，每一个 `plugin` 又有着怎样的用途呢？除了使用 `vue inspect plugins` 我们还可以通过运行 `vue ui` 进入可视化页面查看，步骤如下

- 打开可视化页面，点击对应项目进入管理页面（如果没有对应项目，需要导入或新建）
- 点击侧边栏 `Tasks` 选项，再点击二级栏 `inspect` 选项
- 点击 `Run task` 按钮执行审查命令

![](https://s.poetries.top/gitee/2020/09/78.png)

> 最后我们从输出的内容中找到 `plugins` 数组，其包含了如下插件（配置项已经省略，增加了定义插件的代码）：

```js
// vue-loader是 webpack 的加载器，允许你以单文件组件的格式编写 Vue 组件
const VueLoaderPlugin = require('vue-loader/lib/plugin');

// webpack 内置插件，用于创建在编译时可以配置的全局常量
const { DefinePlugin } = require('webpack');

// 用于强制所有模块的完整路径必需与磁盘上实际路径的确切大小写相匹配
const CaseSensitivePathsPlugin = require('case-sensitive-paths-webpack-plugin');

// 识别某些类型的 webpack 错误并整理，以提供开发人员更好的体验。
const FriendlyErrorsPlugin = require('friendly-errors-webpack-plugin');

// 将 CSS 提取到单独的文件中，为每个包含 CSS 的 JS 文件创建一个 CSS 文件
const MiniCssExtractPlugin = require("mini-css-extract-plugin");

// 用于在 webpack 构建期间优化、最小化 CSS文件
const OptimizeCssnanoPlugin = require('optimize-css-assets-webpack-plugin');

// webpack 内置插件，用于根据模块的相对路径生成 hash 作为模块 id, 一般用于生产环境
const { HashedModuleIdsPlugin } = require('webpack');

// 用于根据模板或使用加载器生成 HTML 文件
const HtmlWebpackPlugin = require('html-webpack-plugin');

// 用于在使用 html-webpack-plugin 生成的 html 中添加 <link rel ='preload'> 或 <link rel ='prefetch'>，有助于异步加载
const PreloadPlugin = require('preload-webpack-plugin');

// 用于将单个文件或整个目录复制到构建目录
const CopyWebpackPlugin = require('copy-webpack-plugin');

module.exports = {
    plugins: [
        /* config.plugin('vue-loader') */
        new VueLoaderPlugin(), 
        
        /* config.plugin('define') */
        new DefinePlugin(),
        
        /* config.plugin('case-sensitive-paths') */
        new CaseSensitivePathsPlugin(),
        
        /* config.plugin('friendly-errors') */
        new FriendlyErrorsWebpackPlugin(),
        
        /* config.plugin('extract-css') */
        new MiniCssExtractPlugin(),
        
        /* config.plugin('optimize-css') */
        new OptimizeCssnanoPlugin(),
        
        /* config.plugin('hash-module-ids') */
        new HashedModuleIdsPlugin(),
        
        /* config.plugin('html') */
        new HtmlWebpackPlugin(),
        
        /* config.plugin('preload') */
        new PreloadPlugin(),
        
        /* config.plugin('copy') */
        new CopyWebpackPlugin()
    ]
}
```
