前端学习（2398）：回顾

# 一、项目初始化

## 使用 Vue CLI 创建项目

> 注意：不要使用 Git Bash 执行项目创建操作，使用  cmd 或者 powershell 之类的工具。

> 如果你还没有安装 VueCLI，或者版本低于 4，请执行下面的命令安装或是升级：
>
> ```shell
> npm install --global @vue/cli
> ```

在命令行中输入以下命令创建 Vue 项目：
```shell
vue create toutiao-publish-admin
```

```shell
Vue CLI v4.2.3
? Please pick a preset:
  default (babel, eslint)
> Manually select features
```
> default：默认勾选 babel、eslint，回车之后直接进入装包
>
> manually：自定义勾选特性配置，选择完毕之后，才会进入装包
>
> 选择第 2 种：手动选择特性，支持更多自定义选项


```shell
? 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
```
> 分别选择：
> Babel：es6 转 es5
> Router：路由
> CSS Pre-processors：CSS 预处理器，后面会提示你选择 less、sass、stylus 等
> Linter / Formatter：代码格式校验，ESLint 代码格式校验


```shell
? Use history mode for router? (Requires proper server setup for index fallback in production) (Y/n) n
```
> 是否使用 history 路由模式，这里输入 `n` 不使用


```shell
? 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
```
> 选择 CSS 预处理器，这里选择我们熟悉的 Less


```shell
? Pick a linter / formatter config:
  ESLint with error prevention only
  ESLint + Airbnb config
> ESLint + Standard config
  ESLint + Prettier
```
> 选择校验工具，这里选择 ESLint + [Standard config](https://standardjs.com/)


```shell
? Pick additional lint features:
 (*) Lint on save
>(*) Lint and fix on commit
```
> 选择在什么时机下触发代码格式校验：
> - Lint on save：每当保存文件的时候
> - Lint and fix on commit：每当执行 `git commit` 提交的时候
>
> 这里建议两个都选上，更严谨。


```shell
? Where do you prefer placing config for Babel, ESLint, etc.? (Use arrow keys)
> In dedicated config files
  In package.json
```
> Babel、ESLint 等工具会有一些额外的配置文件，这里的意思是问你将这些工具相关的配置文件写到哪里：
> - In dedicated config files：分别保存到单独的配置文件
> - In package.json：保存到 package.json 文件中
>
> 这里建议选择第 1 个，保存到单独的配置文件，这样方便我们做自定义配置。


```shell
? Save this as a preset for future projects? (y/N) N
```
> 这里里是问你是否需要将刚才选择的一系列配置保存起来，然后它可以帮你记住上面的一系列选择，以便下次直接重用。

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


```shell
✨  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
```
> 向导配置结束，开始装包。
> 安装包的时间可能较长，请耐心等待......


```shell
⚓  Running completion hooks...

�  Generating README.md...

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

 $ cd topline-m
 $ npm run serve
```
安装结束，命令提示你项目创建成功，按照命令行的提示在终端中分别输入：

```shell
# 进入你的项目目录
cd toutiao-webapp

# 启动开发服务
npm run serve
```




```shell
 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.
```
> 启动成功，命令行中输出项目的 http 访问地址。
> 打开浏览器，输入其中任何一个地址进行访问。




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

## 初始目录结构说明



## 加入 Git 版本管理

建议在项目的一开始就加入版本管理，通过版本管理，我们可以得到很多好处，例如：

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

下面是具体的操作流程。

（1）创建远程仓库（GitHub、Gitee、coding）。。。。

（2）把本地仓库推送到远程仓库

如果没有本地仓库：

```shell
# 初始化本地仓库
git init

# 把文件添加到暂存区
git add README.md

# 把暂存区文件提交到本地仓库形成历史记录
git commit -m "first commit"

# 添加远端仓库地址到本地仓库
git remote add origin https://github.com/lipengzhou/toutiao-publish-admin.git

# 推送到远程仓库
git push -u origin master
```



如果已有本地仓库

> VueCLI 在创建项目的时候自动帮你初始化了 `Git` 仓库，并且基于初始代码默认执行了一次提交。

```shell
git remote add origin https://github.com/lipengzhou/toutiao-publish-admin.git

# -u 就是记住本次推送的信息，下次就不用写推送信息了，可以直接 git push
git push -u origin master
```

（3）之后如果有代码变动需要提交

```shell
git add
git commit

# 推送到远程仓库
# 推送的时候如果不改变远程仓库和分支的话就直接
git push

# 如果推送的远程仓库或是分支改变了
$ git push -u 远程仓库 分支名称
```



> 扩展：管理远程仓库地址信息
>
> ```shell
> # 查看使用帮助
> git remote --help
> 
> # 查看所有的远程仓库信息
> git remote -v
> 
> # 添加远程仓库地址信息
> git remote add 名称 远程仓库地址
> 
> # 删除指定的远程仓库信息
> git remote remove 名称
> 
> # 修改远程仓库地址信息
> git remote set-url 远程仓库地址名称 新地址
> ```

## 调整初始目录结构

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

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

1、将 `App.vue` 修改为：

```html
<template>
  <div id="app">
    <h1>黑马头条内容发布系统</h1>
    <!-- 路由出口 -->
    <router-view/>
  </div>
</template>

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

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

```

2、将 `router/index.js` 修改为：

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

Vue.use(VueRouter)

// 路由配置表
const routes = []

const router = new VueRouter({
  routes
})

export default router

```

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 文件，设置全局样式
  - 在 `main.js` 中加载全局样式 `import './styles/index.less'`



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

```
.                                 
├── 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               
    └── views
```

## JavaScript 代码规范

### 什么是编码规范

### 如何统一编码规范

ESLint。

### 流行的编码规范

- Airbnb JavaScript Style
  - 非常严谨，规则特别多

- JavaScript Standard Style
  - 相比 Airbnb JavaScript Style 要宽松一些。

我们项目中使用的是 [JavaScript Standard Style](https://standardjs.com/readme-zhcn.html) 代码风格。下面是它的一些具体规则要求：

### JavaScript Standard Style 规范说明

建议把：https://standardjs.com/rules-zhcn.html 看一遍，然后在写的时候遇到错误就查询解决。

- **使用两个空格** – 进行缩进

- **字符串使用单引号** – 需要转义的地方除外

- **不再有冗余的变量** – 这是导致 _大量_ bug 的源头!

- **无分号** – [这](http://blog.izs.me/post/2353458699/an-open-letter-to-javascript-leaders-regarding)[没什么不好。](http://inimino.org/~inimino/blog/javascript_semicolons)[不骗你！](https://www.youtube.com/watch?v=gsfbh17Ax9I)

- 行首不要以 `(`, `[`, or ``` 开头

  - 这是省略分号时**唯一**会造成问题的地方 – _工具里已加了自动检测！_
  - [详情](https://standardjs.com/rules-zhcn.html#semicolons)

- **关键字后加空格** `if (condition) { ... }`

- **函数名后加空格** `function name (arg) { ... }`

- 坚持使用全等 `===` 摒弃 `==` 一但在需要检查 `null || undefined` 时可以使用 `obj == null`。

- 一定要处理 Node.js 中错误回调传递进来的 `err` 参数。

- 使用浏览器全局变量时加上 `window` 前缀

  - document 和 navigator 除外

  - 避免无意中使用到了这些命名看上去很普通的全局变量， `open`, `length`, `event` 还有 `name`。

- **查看更多** – _为何不试试 standard 规范呢！_

说了那么多，看看[这个遵循了 Standard 规范的示例文件](https://github.com/expressjs/body-parser/blob/master/index.js) 中的代码吧。或者，这里还有[一大波使用了此规范的项目](https://raw.githubusercontent.com/standard/standard-packages/master/all.json) 代码可供参考。

### 如何解决代码规范错误

<img src="assets/image-20200420112418029.png" alt="image-20200420112418029" style="zoom:50%;" />

如果你不认识命令行中的语法报错是什么意思，你可以根据错误代号去 ESLint 规则列表中查找其具体含义。

什么是错误代号？

<img src="./assets/1561024746437.png" alt="1561024746437" style="zoom:50%;" />

> 括号中的就是错误代码。
>
> semi
>
> keyword-spacing
>
> space-before-function-paren

打开 [ESLint 规则表](https://cn.eslint.org/docs/rules/)，使用页面搜索（Ctrl + F）这个代码，查找对该规则的一个释义。

<img src="./assets/1561024887156.png" alt="1561024887156" style="zoom:50%;" />

> 例如我通过页面页面查找 `space-before-function-paren` 规则代号的释义。

### 关于 Vue.js 代码规范

> 非强制要求，但是建议按照一定格式来写。

参考：[官方风格指南](https://cn.vuejs.org/v2/style-guide/)。

## Element 组件库

### Element 介绍

Element 是饿了么前端团队开发的一个基于 Vue.js 的桌面端组件库，它提供的组件非常丰富，不仅功能强大，而且简单易用。

Element 非常的流行，大多数基于 Vue.js 开发的管理系统都会使用到它。

- 官网：https://element.eleme.io/
- GitHub 仓库：https://github.com/ElemeFE/element
  - 目前已有 44.8k 的 Star 了

### 导入到项目中

1、安装

```bash
npm i element-ui
```

2、在 `main.js` 中配置 element 组件库

```js
/**
 * 项目的启动入口
 */

import Vue from 'vue'
import App from './App.vue'
import router from './router'

// 加载 element 组件库
import ElementUI from 'element-ui'

// 加载 element 组件库的样式
import 'element-ui/lib/theme-chalk/index.css'

// 加载全局样式文件
import './styles/index.less'

// 全局注册 element 组件库
Vue.use(ElementUI)

Vue.config.productionTip = false

// 创建 Vue 根实例
// 把 router 配置到根实例中
// 通过 render 方法把 App 根组件渲染到 #app 入口节点
new Vue({
  router,
  render: h => h(App)
  // el: '#app' // 等价于 $mount('#app')
}).$mount('#app')

```

### 使用说明

用哪个组件就看哪个组件的说明文档。

复制 -> 粘贴 -> try-try-see。



## 封装请求模块

为了方便，我们在这里把 axios 单独封装一个模块用于项目中的请求操作。

```js
/**
 * 基于 axios 封装的请求模块
 */
import axios from 'axios'

// axios()
// axios.get()
// axios.post()

// 创建一个 axios 实例，说白了就是复制了一个 axios
// 我们通过这个实例去发请求，把需要的配置配置给这个实例来处理
const request = axios.create({
  baseURL: 'http://ttapi.research.itcast.cn/' // 请求的基础路径
})

// 请求拦截器

// 响应拦截器

// 导出请求方法
export default request

// 谁要使用谁就加载 request 模块
// import request from 'request.js'
// request.xxx
// request({
//   method: ,
//   url: ''
// })

```