vue-cli4 项目框架的搭建 以及 路由的封装axios的封装公共函数js文件的封装引用vuex的基本用法minins混入css以及字体图标和图片的引入等

Posted smil、梵音

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了vue-cli4 项目框架的搭建 以及 路由的封装axios的封装公共函数js文件的封装引用vuex的基本用法minins混入css以及字体图标和图片的引入等相关的知识,希望对你有一定的参考价值。

前言

之前一直用的是 vue-cli 的 2.x 的版本,现在 vue-cli 都已经升级到 4.x 的版本了,所以在此记录一下 vue-cli4.x 的搭建项目的过程。

之前自己也只是用 vue-cli 的 2.x 版本创建了一个项目,能跑起来就行了,对其中的很多东西都没有深入的封装,这次想借助 vue-cli4.x 的版本做一个全面的记录,包括 vue-cli4.x 创建项目的过程,路由的封装、axios的封装、公共函数的封装、vuex的封装使用、mixins混入、css文件的引入、vue中字体图标的使用、图片的引入和使用等等。

一、vue-cli创建项目

1、前期准备工作

node.js的10.0.0以上版本(必须)、cnpm(淘宝镜像)(可选)、vue-cli4以上版本(必须)

1.1、node.js(10.0.0以上版本)

去 nodejs官网 下载node,选择自己电脑的版本进行相对应的下载,安装完成后

在命令行输入: node -v  或者 node --version 即可查看当前电脑的node版本号

在命令行输入: npm -v 或者 npm --version 即可查看下载node时自动下载的npm的版本号

1.2、 vue-cli(4.x版本)

下载完node,就可以用node提供的npm来下载我们的主角vue-cli了。

如果你不确定自己的电脑是否安装有vue-cli,可以在命令行中输入 vue -V (注意 -V 中的 V 是大写的)或者 vue --version 来进行查看,如果版本已经是4.x的了,这一步就可以跳过了。

如果版本不是4.x,但是想用4.x的话,

可以在命令行输入:npm uninstall -g vue-cli 进行当前 vue-cli 的卸载。

然后在命令行输入:npm install -g @vue/cli 进行 vue-cli 最新版本的安装。

 如果想安装指定版本的vue-cli只需在最新版本安装的命令后面加上@版本号即可,举例:npm install -g @vue/cli@4.4.6

 

1.3、cnpm(淘宝镜像)

使用npm进行下载操作时,由于是从国外的服务器进行下载操作,所以有时会因为网络因素导致下载速度特别慢或者插件下载失败,因此淘宝团队就弄了这个造福程序员的cnpm。装这个主要是为了在进行一些插件下载操作的时候会快些,看个人选择,可装可不装。

安装:在安装完node之后,就可以可以使用node的npm包管理工具了,我们就可以在命令行工具里输入:

npm install -g cnpm -registry=https://registry.npm.taobao.org

然后回车等待安装完成即可,安装完成以后可以输入 cnpm -v,来进行当前cnpm版本号的查看。

 2、项目创建

 2.1、在项目文件夹进入命令行

创建一个文件夹用来存放我们的项目,因为是用传统的命令行创建,所以我们首先要进入到项目将要存在的文件夹命令行。通过win+R,然后输入cmd,再一层一层cd进入文件夹的方式太慢了。

这里有一个方法可以直接进入,那就是在预备创建项目文件的文件夹的地址栏输入cmd,然后按回车键,就可以进入到处于该路径的命令行工具进行操作了。

在这里,我是在D盘中创建了一个 vueTest 的文件夹:

在地址栏中输入 cmd ,然后按回车键:

 

 

 如果不习惯这种操作,因为win10系统里面没有右键打开命令行的功能,想添加右键打开命令行的功能,移步这篇文章:Win10添加右键在此处打开命令行

2.2、项目创建

在命令行输入 vue create 项目名称 ,下图中的项目名称为 vue-demo ,注意项目名称不能为中文,也不能为驼峰式(如 vueDemo)。

注:vue creat命令在哪个目录下运行vue在哪个目录下创建目录。)

 接着按下回车,耐心等待项目的创建即可,如果网速比较慢,系统会提示是否要用 cnpm 创建:

 选择不使用 cnpm,继续......创建完毕后,会显示如下界面:

让我们选择已有配置方案,配置方案有三种。

第一个、第二个是默认的配置,由于默认配置中选中的模块较少,仅提供 babel 和 eslint 支持。

所以我们选择第三个Manually select features ,手动添加需要的配置。

通过上下键选择,移动到第三个配置,然后回车,出现下图:

上面一共有10项,我们可以通过键盘上下键来进行切换,通过空格键进行选中与取消选中,确认选择完毕后,按回车下一步,接下来对着10项逐个介绍

选项 解释
Choose Vue version 选择vue的版本
Babel 将es6 语法转换成兼容的 js(选)
TypeScript 支持使用 TypeScript 语法来编写代码(不选)
Progressive Web App(PWA)Support

渐进式网络应用(不选)

(pwa为应用多项技术的web app。核心技术包括 App Mainfest、Service Worker、Web Push,等等)

Router vue的路由管理组件(选)
Vuex vue的状态仓库管理组件(选)
CSS Pre-processors CSS预编译(选)
Linter/Formatter  代码检验 格式检查(不选)
Unit Testing 单元测试 以开发角度测试代码(不选)
E2E Testing e2e测试 以用户角度测试代码(不选)

( 注意:选择哪些配置不是固定的,根据个人开发喜好自行选择。)
创建项目后可以通过其他方式增加删除模块。选完之后,按下回车键:
 

 vue3.0是2020年09月18日正式发布的。在这里我选择的是 2.x 的版本。

有兴趣了解 2.x 和 3.x 版本区别的,移步这里:vue-cli4 搭建项目时,关于 Choose Vue version 中 2.x 与 3.x 的区别

选择 2.x ,按下回车键:

 因为选择了Router,所以要进行进一步选择:是否使用history模式,因为history模式需要后端支持,所以我选择了否继续使用原来的哈希模式,按下n然后回车Enter: 

 css 的预处理器我选择的是 Sass/SCSS(with dart-sass) 。node-sass是自动编译实时的,dart-sass需要保存后才会生效。

sass 官方目前主力推 dart-sass, 最新的特性都会在这个上面先实现。

按下回车键,继续:

这个选项的意思是选择将babel、Eslint、etc等配置文件放在哪里?
In dedicated config files  =>  一个专门的配置文件(选择了这项,在项目生成时会生成一个单独的新的配置文件)
In package.json => 放在package.json中 (选择了这项,就直接放在了package.json中)

我这里选择了下面的 In package.json 回车:

 这一行询问的是,是否将刚刚设置的一串配置保存下来,如果保存了,在下一次创建项目就会有这个选项出来,我这选择的是不保存,n、Enter。进入项目的创建。等待。。。

可以看到提示成功创建了项目 ‘项目名称’
还有两个提示:
  cd vue-demo  => 进入项目文件
  npm run serve  =>(进入项目文件后)运行项目
至此,整个基于vue-cli的4.x版本命令行创建的项目算是成功结束了!!!

3、环境配置(回头待细细研究)

在项目根目录下新建 .env、 .env.test、.env.dev、 .env.prod的文件:

.env         =>    全局默认配置文件,不论什么环境都会加载合并

.env.test   =>    测试环境下的配置文件

.env.dev => 开发环境下的配置文件

.env.prod   =>   生产环境下的配置文件

注意:只支持:VUE_APP_ 开头,比如设置变量 VUE_APP_NAME=11,在main.js输出console.log(process.env);控制台看到如下信息:

.env 代码如下:

NODE_ENV="development"
VUE_APP_BASE_URL="本地环境域名"

.env.test 代码如下:

NODE_ENV="test"
VUE_APP_BASE_URL="测试环境域名"

.env.pre 代码如下:

NODE_ENV="dev"
VUE_APP_BASE_URL="开发环境域名"

.env.prod 代码如下:

NODE_ENV="production"
VUE_APP_BASE_URL="生产环境域名"

在 package.json 的 scripts 命令中添加对应的 mode (注意,名字要与 --mode 后面的名字分别对应):

"scripts": {
    "serve": "vue-cli-service serve",
    "test": "vue-cli-service build --mode test",         //测试
    "dev": "vue-cli-service build --mode dev",           //开发
    "build": "vue-cli-service build --mode production"   //生产
} 

ok,这样环境就配置好了,分别用以下命令来打包不同环境的包就可以了

npm run test    //测试
npm run dev     //预发布
npm run prod    //生产

4、项目配置

从 vue-cli3.0 开始 build 和 config 目录就取消了,如果需要修改配置,可以在项目的根目录新建一个 vue.config.js 文件来覆盖项目的配置,因为项目的配置比较多。

这篇文章做了一些常用的简单介绍,可以移步这里:vue-cli4 中的 vue.congfig.js 的基本配置

如果想了解更多,移步官方文档:vue.config.js 官方文档

5、项目目录结构

新创建项目结构如下:

├── public                     # 静态资源
│   ├── favicon.ico                # favicon图标
│   └── index.html                 # html模板
├── src                        # 源代码
│   ├── components                 # 全局公用组件
│   ├── router                     # 路由
│   ├── store                      # 全局store管理
│   ├── views                      # views所有页面
│   ├── App.vue                    # 入口页面
│   ├── main.js                    # 入口文件 加载组件 初始化等
├── .env.xxx                   # 环境变量配置
├── .eslintrc.js               # eslint 配置项(无此文件)
├── .gitignore                 # git忽略文件设置
├── .babel.config.js           # babel-loader 配置
├── package.json               # package.json
└── vue.config.js              # vue-cli 配置

二、修改项目结构

因为后续要对路由进行封装,所以现在基于vue-cli搭建的项目结构上,修改一些文件。

App.vue 中:

 Home.vue 中的代码结构为(留意注释的内容):

三、路由的封装

然后添加一些文件,主要是在 views 文件夹中添加了 水果、动物 模块的代码,在路由中新建了 modules 文件夹,里面添加 水果、动物 模块的路由。

代码目录如下:

接下来介绍路由的封装,具体详见:vue 路由的封装

四、axios 的封装

首先安装 axios ,在命令行执行

npm i axios -s

然后在 src 目录下新建一个 serversApi 的文件夹,然后新建 axios.js 和 request.js 文件。代码结构如下图:

 具体用法详见:vue项目中 axios 的封装

五、公共 js 文件的封装

具体用法详见:vue 项目中公共 js 文件的封装

六、vuex 的应用

具体用法详见:vue 项目中的 vuex 简单封装

七、mixins 混入的应用

具体用法详见:vue 中 mixins 的使用方法

八、css、字体图标 和 图片的引入和用法

 具体用法详见:vue 项目中css文件、字体图标、图片的引入和用法

 

以上是关于vue-cli4 项目框架的搭建 以及 路由的封装axios的封装公共函数js文件的封装引用vuex的基本用法minins混入css以及字体图标和图片的引入等的主要内容,如果未能解决你的问题,请参考以下文章

vue-cli3.0/4.0搭建项目

vue多页面项目搭建(vue-cli 4.0)

vue-cli+webpack搭建简单的vue项目框架

IDEA搭建vue-cli | vue-router | 排错思路WebpackAxios周期路由异步重定向

使用vue-cli脚手架搭建简单项目框架

vue-cli4搭建