本章概要

  • 简介
  • 安装
  • 创建项目
    • vue create
    • 使用图形界面

在开发大型单页面应用时,需要考虑项目的组织结构、项目构建、部署、热加载、代码单元测试等多方面与核心业务逻辑无关的事情,对于项目中用到的构建工具、代码检查工具等还需要一遍一遍地重复配置。
显然这很浪费时间,影响开发效率。为此,会选择一些能够创建脚手架的工具,来帮助搭建一个项目的框架,并进行一些项目所依赖的初始配置。
在Vue.js环境中,这个脚手架工具就是 Vue CLI ,利用这个工具,可以自动生成一个极具 Vue.js 的单页应用的脚手架项目。

13.1 简介

Vue CLI 是一个基于 Vue.js 进行快速开发的完整系统,在 Vue 3.0 版本正式发布时,Vue CLI 将包名由原来的 vue-cli 改成了 @vue/cli
Vue CLI 有 3 个组件

  1. CLI (@vue/cli)

全局安装的 npm 包,提供了终端里的 vue 命令(如 vue create、vue serve、vue ui等)。它提供了通过 vue create 快速搭建新项目的能力,或者通过 vue serve 即时原型化新想法的能力。还可以通过 vue ui 使用图形用户界面管理项目。

  1. CLI 服务(@vue/cli-service)

CLI 服务是一个开发环境依赖。它是一个 npm 包,本地安装到 @vue/cli 创建的每个项目中。CLI 服务是构建于 webpack 和 webpack-dev-server 之上的,包含:

  • 加载其它 CLI 插件的核心服务
  • 一个为绝大部分应用优化过的内部 webpack 配置
  • 项目内部的 vue-cli-service 命令,包含基本的 serve、build 和 inspect 命令
  1. CLI 插件

CLI 插件时给 Vue 项目提供可选功能的 npm 包(如 Babel/TypeScript 转译、ESLint 集成、单元测试和端到端的测试等)。Vue CLI 插件的名字以 @cli/cli-plugin-(用于内置插件)或 vue-cli-plugin-(用于社区插件)开头,非常容易使用。当在项目内部运行 vue-cli-service 命令时,它会自动解析并加载项目的 package.json 文件中列出的所有 CLI 插件。
插件可以作为项目创建过程的一部分包括在项目中,也可以稍后添加到项目中。

13.2 安装

可以使用下面的命令安装 Vue CLI

npm install -g @vue/cli@4.5.9
# 或者
yarn global add @vue/cli@4.5.9

Vue CLI 在 Vue 项目开发中基本是必须的,因此要采用全局安装。
安装完成后,可以使用下面的命令检查版本是否正确,同时验证 Vue CLI 是否安装成功。

vue --version

在这里插入图片描述

以下为 vue 的卸载命令

# 3.0以下版本卸载
npm uninstall vue-cli -g

# 3.0以上版本卸载
npm uninstall -g @vue/cli

以下为 vue 的安装命令

# 安装的是最新版
npm install -g vue/cli

# 指定版本安装【指定版本为3.0以下版本】,其中2.9.6为版本 号
npm install vue-cli@2.9.6

# 安装的是3.0以上最新版
npm install -g @vue/cli

# 指定版本安装【指定版本为3.0以上版本】,其中3.11.0为 版本号
npm install -g @vue/cli@3.11.0

13.3 创建项目

安装完 Vue CLI ,就可以开始创建一个脚手架项目了。创建项目有两种方式:一种是通过 vue create [项目名] 命令,以命令行方式创建一个项目;另一种是通过 vue ui 命令 启动图形界面创建项目。

13.3.1 vue create

选择好项目存放的目录,打开命令提示符窗口,输入 vue create helloworld ,开始创建一个 helloworld 项目,如图:
在这里插入图片描述

提示:
项目名中不能有大写字母

首先会让你选择一个 preset (预设),第 1 和第 2 个选项时默认设置,适合快速创建项目的原型,此处不会用到第 1 个选项,因为它是针对 Vue 2.x 版本的。第 3 个选项需要手动对项目进行配置,适合有经验的开发者。这里使用方向键 ↓选择第 3 项,然后按 Enter 键,出现项目的配置选项,如下:
在这里插入图片描述

以上选项的说明如下表:

选项说明
Choose Vue version选择 Vue 版本
Babel转码器,用于将 ES6 代码转为 ES5 代码,从而在现有环境下执行
TypeScriptTypeScript 是 JavaScript 的一个超集,主要提供了类型系统和对 ES6 的支持。TypeScript 是由微软开发的开源编程语言,它可以编译成纯 JavaScript,编译出来的 JavaScript 可以运行在任何浏览器上
Progressive Web App(PWA) Support支持渐进式 Web 应用程序
Routervue-router,参看《十四、使用Vue Router开发单页应用》
VuexVue 的状态管理,参看《十六、状态管理——Vuex》
CSS Pre-processorsCSS 预处理器(如Less、Sass)
Linter / Formatter代码风格检查和格式校验(如 ESLint)
Unit Testing单元测试
E2E Testing端到端测试

保持默认的 Choose Vue version 、Babel 和 Linter / Formatter 的选中状态,按 Enter 键,接下来会根据选择的功能提示选择具体的功能包,或者进一步配置,如图:
在这里插入图片描述

按↓键选中 3.x (Preview),按Enter键,开始配置代码格式和校验选项,如图:
在这里插入图片描述

第 1 个选项是指 ESLint 仅用于错误预防,后 3 个选项是选择 ESLint 和哪一种代码规范一起使用。ESLint 是用于代码校验的,至于代码风格,则由灵盖的规范来限制,如这里的 Airbnb config、Standard config 和 Prettier。至于选择哪种代码规范,这要看个人的喜好或公司的要求。这里先保持默认选,即第一个选项 ESLint with error prevention only。
接下来是选择合适检测代码。如下:
在这里插入图片描述

这里选择第 1 项:保存时检测。接下来是询问如何存放配置信息,如下:
在这里插入图片描述

第 1 个选项时指在专门的配置文件中存放配置信息,第 2 个选项是把配置信息放到 package.json 文件中。
选择第 1 个选项并按 Enter 键,接下来询问是否保存本次配置,保存的配置可以供以后项目使用,如下图。
在这里插入图片描述

如果选择了保存,以后再用 vue create 命令创建项目时,就会出现保存过的配置,然后直接选择该配置即可。
输入 y 并按 Enter 键,接下来是给本次配置取个名字,如下:
在这里插入图片描述

输入名字并按 Enter 键,开始创建脚手架项目,这中间会根据配置自动下载需要的包。项目创建完成后,界面信息如下:
在这里插入图片描述

根据提示在命令提示符窗口中依次输入 cd helloworld 和 npm run serve(运行项目)。运行结果如下:
在这里插入图片描述

打开谷歌浏览器,输入 http://localhost:8080/,即可看到这个脚手架项目的默认页面,如图:
在这里插入图片描述

要终止项目运行,在命令提示符窗口中按 Ctrl + C 组合键即可。
Vue create 命令有一些可选项,可以输入 vue create --help 查看这些选项。具体的选项说明如下:

-p, --preset <presetName>       //忽略提示符并并使用以保存的或远程的预设选项
-d, --default                   //忽略提示符并使用默认预设选项
-i, --inlinePreset <json>       //忽略提示符并使用内联的JSON字符串预设选项
-m, --packageManager <command>  //在安装依赖时使用指定的npm客户端
-r, --registry <url>            //在安装依赖时使用指定的npm registry
-g, --git [message]             //强制git初始化,并指定初始化提交信息(可选的)
-n, --no-git                    //调过git初始化
-f, --force                     //如果目标目录存在,则覆写它
--merge                         //如果目标目录存在,则合并它
-c, --clone                     //使用git clone 获取远程预设选项
-x, --proxy <proxyUrl>          //使用指定的代理创建项目
-b, --bare                      //创建脚手架项目时省略新手指导信息
--skipGetStarted                //调过显示 Get Started 说明
-h, --help                      //输出使用帮助信息

如果要删除自定义的脚手架项目的配置,则可以在操作系统的用户目录下找到 .vuerc 文件。该文件内容如下:
在这里插入图片描述

在这里插入图片描述

红框中的代码部分就是脚手架项目配置,如果不想要,删除即可。

13.3.2 使用图形界面

在命令提示符窗口中输入 vue ui,会在浏览器窗口打开Vue项目的图形界面管理程序。在这个管理程序中可以创建新项目、管理项目、配置插件和项目依赖、对项目进行基础设置,以及执行任务。
通过图形界面创建新项目的界面如图:
在这里插入图片描述

可以根据提示,分步完成项目的创建

Logo

前往低代码交流专区

更多推荐