项目预览地址：

# 一、项目初始化

目标

能使用 Vue CLI 创建项目

了解 Vant 组件库的导入方式

掌握制作使用字体图标的方式

掌握如何在 Vue 项目中处理 REM 适配

理解 axios 请求模块的封装

# 1、使用 Vue CLI 创建项目

如果你还没有安装 VueCLI，请执行下面的命令安装或是升级：
npm install --global @vue/cli  // 全局安装脚手架
1

在命令行中输入以下命令创建 Vue 项目：

vue create toutiao-m   // 创建项目

Vue CLI v4.2.3
? Please pick a preset:
  default (babel, eslint)
> Manually select features  // 更多个性化配置

1
2
3
4

default：默认勾选 babel、eslint，回车之后直接进入装包

manually：自定义勾选特性配置，选择完毕之后，才会进入装包

选择第 2 种：手动选择特性，支持更多自定义选项

? Please pick a preset: Manually select features
? Check the features needed for your project:
 (*) Babel
 ( ) TypeScript
 ( ) Progressive Web App (PWA) Support
 (*) Router
 (*) Vuex
 (*) CSS Pre-processors
>(*) Linter / Formatter
 ( ) Unit Testing
 ( ) E2E Testing

1
2
3
4
5
6
7
8
9
10
11

分别选择： Babel：es6 转 es5 Router：路由 Vuex：数据容器，存储共享数据 CSS Pre-processors：CSS 预处理器，后面会提示你选择 less、sass、stylus 等 Linter / Formatter：代码格式校验

? Use history mode for router? (Requires proper server setup for index fallback in production) (Y/n) n

是否使用 history 路由模式，这里输入 n 不使用

? Pick a CSS pre-processor (PostCSS, Autoprefixer and CSS Modules are supported by default):
  Sass/SCSS (with dart-sass)
  Sass/SCSS (with node-sass)
> Less
  Stylus

1
2
3
4
5

选择 CSS 预处理器，这里选择我们熟悉的 Less

? Pick a linter / formatter config:
  ESLint with error prevention only
  ESLint + Airbnb config
> ESLint + Standard config
  ESLint + Prettier

1
2
3
4
5

选择校验工具，这里选择 ESLint + Standard config (opens new window)

? Pick additional lint features:
>(*) Lint on save
 (*) Lint and fix on commit

1
2
3

选择在什么时机下触发代码格式校验：

Lint on save：每当保存文件的时候

Lint and fix on commit：每当执行 git commit 提交的时候

这里建议两个都选上，更严谨。

? Where do you prefer placing config for Babel, ESLint, etc.? (Use arrow keys)
> In dedicated config files
  In package.json

1
2
3

Babel、ESLint 等工具会有一些额外的配置文件，这里的意思是问你将这些工具相关的配置文件写到哪里：

In dedicated config files：分别保存到单独的配置文件

In package.json：保存到 package.json 文件中

这里建议选择第 1 个，保存到单独的配置文件，这样方便我们做自定义配置。

? Save this as a preset for future projects? (y/N) N

这里里是问你是否需要将刚才选择的一系列配置保存起来，然后它可以帮你记住上面的一系列选择，以便下次直接重用。

这里根据自己需要输入 y 或者 n，我这里输入 n 不需要。

✨  Creating project in C:\Users\LPZ\Desktop\topline-m-fe89\topline-m-89.
�  Initializing git repository...
⚙  Installing CLI plugins. This might take a while...

[          ........] - extract:object-keys: sill extract json5@2.1.1

1
2
3
4
5

向导配置结束，开始装包。安装包的时间可能较长，请耐心等待......

⚓  Running completion hooks...

�  Generating README.md...

�  Successfully created project topline-m-89.
�  Get started with the following commands:

 $ cd toutiao-m
 $ npm run serve

1
2
3
4
5
6
7
8
9

安装结束，命令提示你项目创建成功，按照命令行的提示在终端中分别输入：

# 进入你的项目目录
cd toutiao-m

# 启动开发服务
npm run serve

1
2
3
4
5

运行效果

 DONE  Compiled successfully in 7527ms


  App running at:
  - Local:   http://localhost:8080/
  - Network: http://192.168.10.216:8080/

  Note that the development build is not optimized.
  To create a production build, run npm run build.

1
2
3
4
5
6
7
8
9

启动成功，命令行中输出项目的 http 访问地址。打开浏览器，输入其中任何一个地址进行访问。

如果能看到该页面，恭喜你，项目创建成功了。

# 2、加入 Git 版本管理

几个好处：

代码备份
多人协作
历史记录
...

（1）创建远程仓库

（2）将本地仓库推到线上

如果没有本地仓库。

# 创建本地仓库
git init

# 将文件添加到暂存区
git add 文件

# 提交历史记录
git commit "提交日志"

# 添加远端仓库地址
git remote add origin 你的远程仓库地址

# 推送提交
git push -u origin master

1
2
3
4
5
6
7
8
9
10
11
12
13
14

如果已有本地仓库（Vue CLI 已经帮我们初始化好了）。

# 添加远端仓库地址
git remote add origin 你的远程仓库地址

# 推送提交
git push -u origin master

1
2
3
4
5

如果之后项目代码有了变动需要提交：

git add
git commit
git push

1
2
3

# 3、调整初始目录结构

默认生成的目录结构不满足我们的开发需求，所以这里需要做一些自定义改动。

这里主要就是下面的两个工作：

删除初始化的默认文件
新增调整我们需要的目录结构

1、将 App.vue 修改为

<template>
  <div id="app">
    <h1>黑马头条</h1>
    <router-view />
  </div>
</template>

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

<style scoped lang="less"></style>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

2、将 router/index.js 修改为

import Vue from 'vue'
import VueRouter from 'vue-router'

Vue.use(VueRouter)

// 路由映射数组
const routes = []
// 实例化路由对象
const router = new VueRouter({
  routes
})

export default router

1
2
3
4
5
6
7
8
9
10
11
12
13

3、删除

src/views/About.vue
src/views/Home.vue
src/components/HelloWorld.vue
src/assets/logo.png

4、创建以下几个目录

src/api 目录
- 存储接口封装
src/utils 目录
- 存储一些工具模块

src/styles 目录

创建index.less 文件，存储全局样式
```
body{
    background-color:red;
}
```
1
2
3

在 main.js 中加载全局样式

import Vue from 'vue'
import App from './App.vue'
import router from './router'
import store from './store'
// 加载全局样式  【增加这一句】
import './styles/index.less'

Vue.config.productionTip = false

new Vue({
  router,
  store,
  render: h => h(App)
}).$mount('#app')

1
2
3
4
5
6
7
8
9
10
11
12
13
14

调整之后的目录结构如下。

.                                 
├── README.md                     
├── babel.config.js               
├── package-lock.json             
├── package.json                  
├── public                        
│   ├── favicon.ico               
│   └── index.html                
└── src                           
    ├── api            // 请求方法
    ├── App.vue        // 根组件              
    ├── assets         // 静态目录             
    ├── components     // 公共组件目录            
    ├── main.js        // 入口文件            
    ├── router         // 路由配置
    ├── utils          // 工具文件
    ├── styles         // 全局样式
    ├── store          // 仓库对象            
    └── views          // 页面视图

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# 4、导入图标素材

设计师为我们单独提供了设计稿中的图标，为了方便使用，我们在这里把它制作为字体图标。

制作字体图标的工具有很多，在这里我们推荐大家使用：https://www.iconfont.cn/。

一、注册账户

直接选择第三方登录即可

二、创建项目

三、上传图标到项目

四、生成链接

五、配置到项目中使用

一种方式是将 SVG 图标包装为 Vue 组件来使用 (opens new window)，这种方式我们这里不做介绍

一种方式是将 SVG 制作为字体图标来使用，以下是项目中配置步骤

创建src/styles/icon.less文件，将字体图标样式内容全部复制进去

@font-face {font-family: "toutiao";
  src: url('//at.alicdn.com/t/font_1715884_c380afk5f66.eot?t=1585203719136'); /* IE9 */
  src: url('//at.alicdn.com/t/font_1715884_c380afk5f66.eot?t=1585203719136#iefix') format('embedded-opentype'), /* IE6-IE8 */
...
// 具体内容去复制自己的

1
2
3
4
5

**在 src/styles/index.less文件中导入字体样式 **

// 全局样式文件

// 加载图标样式
@import "./icon.less";  // 注意这里要分号结尾

1
2
3
4

在App.vue中测试是否可以使用

<template>
  <div id="app">
    <i class="toutiao toutiao-shouye"></i>  <!--此时界面中应该可以显示图标说明使用正常-->
    <!-- 路由的出口 -->
    <router-view/>
  </div>
</template>

1
2
3
4
5
6
7

六、导入图片素材

将资料/素材 里面的图片复制到 src/assets目录里面去

将 favicon.ico文件放到 public 目录里，替换原有内容

# 5、引入 Vant 组件库

移动端组件库：
- mint-ui https://mint-ui.github.io/#!/zh-cn
- ydui http://vue.ydui.org/docs/#/spinner
- NutUi https://nutui.jd.com/#/index
前台UI库的使用：
- 如果项目有专业的设计图，且设计图和市面上的UI库不接近匹配，那我们就使用自己书写的方式，但是如果项目中没有被设计图规定的，且比较复杂的组件，我们可以从第三方的UI库中按需导入使用。
- 如果项目没有设计图，或者设计图里面的效果很接近UI库，那我们就可以使用UI库，在这个基础上自定义样式接近设计图。
- 原则就是：好用、节省时间

Vant 是有赞商城前端开发团队开发的一个基于 Vue.js 的移动端组件库，它提供了非常丰富的移动端功能组件，简单易用。

下面是在 Vant 官网中列出的一些优点：

60+ 高质量组件
90% 单元测试覆盖率
完善的中英文文档和示例
支持按需引入
支持主题定制
支持国际化
支持 TS
支持 SSR

在我们的项目中主要使用 Vant 作为核心组件库，下面我们根据官方文档 (opens new window)将 Vant 导入项目中。

将 Vant 引入项目一共有四种方式：

方式一：自动按需引入组件
- 和方式二一样，都是按需引入，但是加载更方便一些（需要额外配置插件）
- 优点：打包体积小
- 缺点：每个组件在使用之前都需要手动加载注册
方式二：手动按需引入组件
- 在不使用插件的情况下，可以手动引入需要的组件
- 优点：打包体积小
- 缺点：每个组件在使用之前都需要手动加载注册
方式三：导入所有组件
- Vant 支持一次性导入所有组件，引入所有组件会增加代码包体积，因此不推荐这种做法
- 优点：导入一次，使用所有
- 缺点：打包体积大
方式四：通过 CDN 引入
- 使用 Vant 最简单的方法是直接在 html 文件中引入 CDN 链接，之后你可以通过全局变量vant访问到所有组件。
- 优点：适合一些演示、示例项目，一个 html 文件就可以跑起来
- 缺点：不适合在模块化系统中使用

这里建议为了前期开发的便利性我们选择方式三：导入所有组件，在最后做打包优化的时候根据需求配置按需加载以降低打包体积大小。

1、安装 Vant

npm i vant

2、在 main.js 中加载注册 Vant 组件

import Vue from 'vue'
import Vant from 'vant'
import 'vant/lib/index.css'

Vue.use(Vant)

1
2
3
4
5

3、查阅文档使用组件

Vant 的文档非常清晰，左侧是组件目录导航，中间是效果代码，右边是效果预览。

例如我们在根组件App.vue中使用 Vant 中的组件：

<van-button type="default">默认按钮</van-button>
<van-button type="primary">主要按钮</van-button>
<van-button type="info">信息按钮</van-button>
<van-button type="warning">警告按钮</van-button>
<van-button type="danger">危险按钮</van-button>

<van-cell-group>
  <van-cell title="单元格" value="内容" />
  <van-cell title="单元格" value="内容" label="描述信息" />
</van-cell-group>

1
2
3
4
5
6
7
8
9
10

如果在页面中能够正常的看到下面的效果，则说明 Vant 导入成功了。

# 6、移动端 REM 适配

Vant 中的样式默认使用 px 作为单位，如果需要使用 rem 单位，推荐使用以下两个工具：

lib-flexible (opens new window) 用于设置 rem 基准值
postcss-pxtorem (opens new window) 是一款 postcss 插件，用于将单位转化为 rem

下面我们分别将这两个工具配置到项目中完成 REM 适配。

一、使用 lib-flexible (opens new window) 动态设置 REM 基准值（html 标签的字体大小）

1、安装

# yarn add amfe-flexible
npm i amfe-flexible

1
2

2、然后在 main.js 中加载执行该模块

import 'amfe-flexible'

最后测试：在浏览器中切换不同的手机设备尺寸，观察 html 标签 font-size 的变化。

例如在 iPhone 6/7/8 设备下，html 标签字体大小为 37.5 px

例如在 iPhone 6/7/8 Plus 设备下，html 标签字体大小为 41.4 px

二、使用 postcss-pxtorem (opens new window) 将 px 转为 rem

1、安装

# yarn add -D postcss-pxtorem
# -D 是 --save-dev 的简写
npm install postcss-pxtorem@5.1.1  -D   // 建议这个版本号

1
2
3

2、然后在项目根目录中创建 .postcssrc.js 文件

vant中有描述关于适配的使用 https://vant-contrib.gitee.io/vant/#/zh-CN/advanced-usage#rem-bu-ju-gua-pei

module.exports = {
  plugins: {
    'postcss-pxtorem': {
      rootValue: 37.5,   // 如果将来是自己的设计图(750px)，直接写75即可！ 就可以设计图是多少px，css书写就写多少px  
      propList: ['*'],
    },
  },
};

1
2
3
4
5
6
7
8

但是上述配置只适用于vant内部的相关组件内容，我们自己书写的样式，并不是按照这个，我们希望设计图是多少px，就写多少px，故而修改内容如下

module.exports = {
  plugins: {
    // postcss-pxtorem 插件的版本需要 >= 5.0.0
    'postcss-pxtorem': {
      rootValue({ file }) {  // 如果是vant的就按照375 尺寸， 如果是其他的就是按照750 
        return file.indexOf('vant') !== -1 ? 37.5 : 75;   // rootValue 的值一般是 设计稿  1/10
      },
      propList: ['*'],
    },
  },
};

1
2
3
4
5
6
7
8
9
10
11

3、配置完毕，重新启动服务

最后测试：刷新浏览器页面，审查元素的样式查看是否已将 px 转换为 rem。

这是没有配置转换之前的。

这是转换之后的，可以看到 px 都被转换为了 rem。

需要注意的是：

该插件不能转换行内样式中的 px，例如 <div style="width: 200px;"></div>

# 7、关于 `.postcssrc.js` 配置文件

module.exports = {
  plugins: {
    'autoprefixer': {
      browsers: ['Android >= 4.0', 'iOS >= 8']
    },
    'postcss-pxtorem': {
      // rootValue: 37.5,
      root Value({ file }) {
        return file.indexOf('vant') !== -1 ? 37.5 : 75
      },
      propList: ['*']
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

.postcssrc.js 是 PostCSS 的配置文件。

（1）PostCSS 介绍

PostCSS (opens new window) 是一个处理 CSS 的处理工具，本身功能比较单一，它主要负责解析 CSS 代码，再交由插件来进行处理，它的插件体系非常强大，所能进行的操作是多种多样的，例如：

Autoprefixer (opens new window) 插件可以实现自动添加浏览器相关的声明前缀
PostCSS Preset Env (opens new window) 插件可以让你使用更新的 CSS 语法特性并实现向下兼容
postcss-pxtorem (opens new window) 可以实现将 px 转换为 rem
...

目前 PostCSS 已经有 200 多个功能各异的插件 (opens new window)。开发人员也可以根据项目的需要，开发出自己的 PostCSS 插件。

PostCSS 一般不单独使用，而是与已有的构建工具进行集成。

Vue CLI 默认集成了 PostCSS (opens new window)，并且默认开启了 autoprefixer (opens new window) 插件。

Vue CLI 内部使用了 PostCSS。

你可以通过 .postcssrc 或任何 postcss-load-config (opens new window) 支持的配置源来配置 PostCSS。也可以通过 vue.config.js 中的 css.loaderOptions.postcss 配置 postcss-loader (opens new window)。

我们默认开启了 autoprefixer (opens new window)。如果要配置目标浏览器，可使用 package.json 的 browserslist (opens new window) 字段。

（2）Autoprefixer 插件的配置

autoprefixer (opens new window) 是一个自动添加浏览器前缀的 PostCss 插件，browsers 用来配置兼容的浏览器版本信息，但是写在这里的话会引起编译器警告。

Replace Autoprefixer browsers option to Browserslist config.
Use browserslist key in package.json or .browserslistrc file.

Using browsers option can cause errors. Browserslist config
can be used for Babel, Autoprefixer, postcss-normalize and other tools.

If you really need to use option, rename it to overrideBrowserslist.

Learn more at:
https://github.com/browserslist/browserslist#readme
https://twitter.com/browserslist

1
2
3
4
5
6
7
8
9
10
11

警告意思就是说你应该将 browsers 选项写到 package.json 或 .browserlistrc 文件中。

#这个值会被 @babel/preset-env 和 Autoprefixer 用来确定需要转译的 JavaScript 特性和需要添加的 CSS 浏览器前缀。
# 具体配置信息  https://github.com/browserslist/browserslist


# 兼容到百分之1的用户使用过的浏览器
> 1%

# 兼容到最后两个版本（指的浏览器版本最后两位位数）
last 2 versions

# 没有挂了的浏览器
not dead

Android >= 4.0
iOS >= 8

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

具体语法请参考这里 (opens new window)。

（3）postcss-pxtorem 插件的配置

rootValue：表示根元素字体大小，它会根据根元素大小进行单位转换
propList 用来设定可以从 px 转为 rem 的属性
- 例如 * 就是所有属性都要转换，width 就是仅转换 width 属性

rootValue 应该如何设置呢？

如果你使用的是基于 lib-flexable 的 REM 适配方案，则应该设置为你的设计稿的十分之一。
例如设计稿是 750 宽，则应该设置为 75。

1
2

大多数设计稿的原型都是以 iphone6 为原型，iphone6 设备的宽是 750，我们的设计稿也是这样。

但是 Vant 建议设置为 37.5，为什么呢？

因为 Vant 是基于 375 写的，所以如果你设置为 75 的话，Vant 的样式就小了一半。

所以如果设置为 37.5 的话，Vant 的样式是没有问题的，但是我们在测量设计稿的时候都必须除2才能使用，否则就会变得很大。

这样做其实也没有问题，但是有没有更好的办法呢？我就想实现测量多少写多少（不用换算）。于是聪明的你就想，可以不可以这样来做？

如果是 Vant 的样式，就把 rootValue 设置为 37.5 来转换
如果是我们的样式，就按照 75 的 rootValue 来转换

通过查阅文档 (opens new window)我们可以看到 rootValue 支持两种参数类型：

数字：固定值
函数：动态计算返回
- postcss-pxtorem 处理每个 CSS 文件的时候都会来调用这个函数
- 它会把被处理的 CSS 文件相关的信息通过参数传递给该函数

所以我们修改配置如下：

/**
 * PostCSS 配置文件
 */

module.exports = {
  // 配置要使用的 PostCSS 插件
  plugins: {
    // 配置使用 autoprefixer 插件
    // 作用：生成浏览器 CSS 样式规则前缀
    // VueCLI 内部已经配置了 autoprefixer 插件
    // 所以又配置了一次，所以产生冲突了
    // 'autoprefixer': { // autoprefixer 插件的配置
    //   // 配置要兼容到的环境信息
    //   browsers: ['Android >= 4.0', 'iOS >= 8']
    // },

    // 配置使用 postcss-pxtorem 插件
    // 作用：把 px 转为 rem
    'postcss-pxtorem': {
      rootValue ({ file }) {
        return file.indexOf('vant') !== -1 ? 37.5 : 75
      },
      propList: ['*']
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

配置完毕，把服务重启一下，最后测试，very good。

# 8、封装请求模块

和之前项目一样，这里我们还是使用 axios (opens new window) 作为我们项目中的请求库，为了方便使用，我们把它封装为一个请求模块，在需要的时候直接加载即可。

1、安装 axios

npm i axios

2、创建 src/utils/request.js

/**
 * 封装 axios 请求模块
 */
import axios from "axios"

// 创建一个axios实例对象
const request = axios.create({
   baseURL: "http://toutiao-app.itheima.net", // 基础路径
})

// 配置请求拦截器

// 配置响应拦截器


// 暴露出去
export default request

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

3、如何使用

方式一（简单方便，但是不利于接口维护）：我们可以把请求对象挂载到 Vue.prototype 原型对象中，然后在组件中通过 this.xxx 直接访问

这种方式的优点是简单，缺点就是一旦维护某个接口，需要修改很多地方，但实际工作中如果该项目不是自己从头开始还是很难找到哪些地方用过，所以缺点就是维护困难
方式二（推荐）：我们把每一个请求都封装成每个独立的功能函数，在需要的时候加载调用，这种做法更便于接口的管理和维护

在我们的项目中建议使用方式二，更推荐（在随后的业务功能中我们就能学到）。

# 一、项目初始化

# 1、使用 Vue CLI 创建项目

# 2、加入 Git 版本管理

# 3、调整初始目录结构

# 4、导入图标素材

# 5、引入 Vant 组件库

# 6、移动端 REM 适配

# 7、关于 .postcssrc.js 配置文件

# 8、封装请求模块

# 9、总结

# 7、关于 `.postcssrc.js` 配置文件