Vue CLI教程：初学者快速入门指南

本文提供了详细的Vue CLI教程，帮助初学者快速入门。内容涵盖了Vue CLI的安装、创建Vue项目、配置项目以及常用命令的使用。此外，还介绍了Vue CLI插件管理和发布Vue应用的流程。通过这些步骤，你可以高效地搭建和部署Vue项目。

什么是Vue CLI

Vue CLI（Vue Command Line Interface）是一个用于构建 Vue.js 项目的命令行工具。它提供了一套预设的构建设置，以帮助开发者快速搭建一个 Vue.js 项目。Vue CLI 可以帮助你处理诸如文件生成、依赖注入、开发服务器启动和构建优化等任务，使得使用 Vue.js 开发应用更加高效和便捷。

如何安装Vue CLI

安装 Vue CLI 需要 Node.js 环境。首先，你需要确保已经安装了 Node.js 和 npm（Node.js 的包管理器）。安装完成后，通过 npm 全局安装 Vue CLI。

npm install -g @vue/cli

安装完成后，可以通过以下命令检查 Vue CLI 是否安装成功：

vue --version

如果安装成功，将会显示 Vue CLI 的版本号。

使用Vue CLI管理项目

除了安装，Vue CLI 还提供了多种命令来管理项目，例如启动图形界面的项目管理工具 vue ui，安装和配置 Vue 插件 vue add，启动开发服务器 vue serve，构建项目 vue build，解包配置文件 vue eject，以及检查项目配置和环境 vue doctor。

使用Vue CLI创建新项目

使用 Vue CLI 创建新项目非常简单。打开终端，运行以下命令：

vue create my-vue-app

这里，my-vue-app 是你的项目名称。运行上述命令后，Vue CLI 会引导你完成项目的创建过程。你可以选择使用默认配置创建项目，或者自定义项目的配置。例如，你可以选择预安装的插件或运行时依赖。

Vue CLI v4.5.0
✨  Creating project in /path/to/my-vue-app
? Please pick a preset (Use arrow keys)
❯ Default ([Vue] babel, eslint)
  Manually select features

项目结构简介

创建项目后，你会看到一个典型的 Vue.js 项目结构。以下是主要的文件和目录：

• public/：存放静态文件，如 index.html, favicon.ico 等。
• src/：存放项目的主要代码。

在 src/ 目录下，你会看到以下文件：

• main.js：项目的主入口文件。
• App.vue：项目的根组件。
• components/：存放自定义的 Vue 组件。
• assets/：存放静态资源，如图片、字体等。
• router/：存放路由配置。
• views/：存放视图组件。

例如，项目的根组件 App.vue 可能会像这样：

<template>
  <div id="app">
    <router-view/>
  </div>
</template>

<script>
export default {
  name: 'App'
}
</script>

<style>
#app {
  font-family: Avenir, Helvetica, Arial, sans-serif;
  text-align: center;
  color: #2c3e50;
  margin-top: 60px;
}
</style>

项目配置文件介绍

Vue CLI 项目默认使用 vue.config.js 文件来配置项目。该文件位于项目的根目录下，是一个可选文件。你可以在该文件中配置项目的各种设置。

以下是 vue.config.js 的基本结构：

module.exports = {
  // 配置文件的根路径
  publicPath: '/',
  // 端口号
  port: 8080,
  // 是否使用模块热替换
  hot: true,
  // 静态资源目录
  assetsDir: 'static',
  // 配置代理
  devServer: {
    proxy: 'http://localhost:3000'
  }
}

例如，假设你希望配置开发服务器的端口号为 8081，并开启代理服务器，可以这样修改 vue.config.js：

module.exports = {
  publicPath: '/',
  port: 8081,
  hot: true,
  assetsDir: 'static',
  devServer: {
    proxy: 'http://localhost:3000'
  }
}

常见配置选项详解

以下是 vue.config.js 中一些常见的配置选项：

• publicPath：部署应用的根路径。默认为 /。如果你的项目部署在路径 /my-app/ 下，则可以设置为 '/'。
• port：开发服务器的端口号。默认值为 8080。
• hot：是否启用模块热替换。默认值为 true。
• assetsDir：静态资源目录。默认值为 'static'。
• devServer：开发服务器配置。可配置代理服务器、开放主机等。
• linterOptions：代码检查选项。可以在 devServer 中配置 ESLint 等。

常用命令列表

Vue CLI 提供了多个常用的命令来管理项目。以下是几个常用的命令：

• vue ui：启动图形界面的项目管理工具。
• vue add：安装和配置 Vue 插件。
• vue serve：启动开发服务器。
• vue build：构建项目。
• vue eject：解包配置文件，暴露所有配置。
• vue doctor：检查项目配置和环境。

命令使用示例

以下是几个常用命令的使用示例：

启动开发服务器

vue serve

运行上述命令后，Vue CLI 会启动一个开发服务器，并自动打开浏览器访问应用。

构建项目

vue build

运行上述命令后，Vue CLI 会构建项目并生成 dist/ 目录，其中包含了构建后的静态文件。

安装插件

vue add vue-router

上述命令将安装 Vue Router 插件，并自动配置项目以使用 Vue Router。

插件的作用与安装

Vue CLI 插件可以扩展 Vue CLI 的功能，使其支持更多的插件和工具。插件可以分为两类：预设插件和自定义插件。预设插件是 Vue CLI 官方提供的插件，而自定义插件是由社区开发的插件。

安装插件的方式有两种：使用 vue add 命令自动安装，或者手动安装。

自动安装插件

vue add vue-router

上述命令会自动安装 Vue Router 插件，并配置项目以使用 Vue Router。

手动安装插件

npm install vue-router --save

手动安装插件后，你需要手动配置项目以使用该插件。

常用插件介绍

Vue Router

Vue Router 是 Vue.js 官方的路由管理库。它允许你定义应用的路由，根据不同的 URL 显示不同的视图。以下是一个简单的 Vue Router 示例：

// 在 src/router/index.js 中定义路由配置
import Vue from 'vue'
import Router from 'vue-router'
import Home from '@/views/Home.vue'
import About from '@/views/About.vue'

Vue.use(Router)

export default new Router({
  routes: [
    {
      path: '/',
      name: 'home',
      component: Home
    },
    {
      path: '/about',
      name: 'about',
      component: About
    }
  ]
})

Vuex

Vuex 是 Vue.js 的状态管理模式。它提供了集中式状态管理，可以很方便地管理应用的状态。以下是一个简单的 Vuex 示例：

// 在 src/store/index.js 中定义状态管理
import Vue from 'vue'
import Vuex from 'vuex'

Vue.use(Vuex)

export default new Vuex.Store({
  state: {
    count: 0
  },
  mutations: {
    increment(state) {
      state.count++
    }
  },
  actions: {
    increment({ commit }) {
      commit('increment')
    }
  },
  getters: {
    count(state) {
      return state.count
    }
  }
})

打包与发布流程

发布 Vue 应用需要先构建项目，然后将构建后的静态文件发布到服务器上。

构建项目

vue build

运行上述命令后，Vue CLI 会构建项目，并生成 dist/ 目录，其中包含了构建后的静态文件。

将构建后的文件部署到服务器

将 dist/ 目录中的文件部署到服务器上，具体步骤取决于你的服务器环境。以下是一个简单的部署流程：

1. 将 dist/ 目录压缩为一个 ZIP 文件。
2. 通过 FTP 或者 SFTP 将 ZIP 文件上传到服务器的指定目录。
3. 解压 ZIP 文件，将文件放置到指定目录。
4. 确保服务器配置正确，可以访问静态文件。

配置服务器环境

例如，如果你使用的是 Apache，可以在服务器上配置 .htaccess 文件，以便正确处理静态文件：

DirectoryIndex index.html
RewriteEngine On
RewriteRule ^index\.html$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule . /index.html [L]

部署到常见平台注意事项

以下是将 Vue 应用部署到常见平台时的一些注意事项：

GitHub Pages

GitHub Pages 是 GitHub 提供的一个静态文件托管服务。你可以将构建后的应用部署到 GitHub Pages。

1. 创建一个 GitHub 仓库。
2. 将构建后的应用上传到仓库的 gh-pages 分支。
3. 设置 GitHub Pages 来使用 gh-pages 分支。

Vercel

Vercel 是一个流行的静态站点托管平台。你可以将构建后的应用部署到 Vercel。

1. 注册并登录 Vercel 账户。
2. 打开 Vercel 项目创建界面。
3. 选择你的 GitHub 仓库。
4. 设置构建命令和部署目标。

通过以上步骤，你可以将 Vue 应用部署到 GitHub Pages 或者 Vercel 上。