一、项目初始化----------项目开发(后台管理系统)
一、项目初始化
使用 Vue CLI 创建项目
注意:不要使用 Git Bash 执行项目创建操作,使用 cmd 或者 powershell 之类的工具。
如果你还没有安装 VueCLI,或者版本低于 4,请执行下面的命令安装或是升级:
npm install --global @vue/cli
在命令行中输入以下命令创建 Vue 项目:
vue create toutiao-publish-admin
Vue CLI v4.2.3
? Please pick a preset:
default (babel, eslint)
> Manually select features
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
分别选择:
Babel:es6 转 es5
Router:路由
CSS Pre-processors:CSS 预处理器,后面会提示你选择 less、sass、stylus 等
Linter / Formatter:代码格式校验,ESLint 代码格式校验
? 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
选择 CSS 预处理器,这里选择我们熟悉的 Less
? Pick a linter / formatter config:
ESLint with error prevention only
ESLint + Airbnb config
> ESLint + Standard config
ESLint + Prettier
选择校验工具,这里选择 ESLint + Standard config
? Pick additional lint features:
(*) Lint on save
>(*) Lint and fix on commit
选择在什么时机下触发代码格式校验:
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
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
向导配置结束,开始装包。
安装包的时间可能较长,请耐心等待......
⚓ Running completion hooks...
� Generating README.md...
� Successfully created project topline-m-89.
� Get started with the following commands:
$ cd topline-m
$ npm run serve
安装结束,命令提示你项目创建成功,按照命令行的提示在终端中分别输入:
# 进入你的项目目录
cd toutiao-webapp
# 启动开发服务
npm run serve
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)把本地仓库推送到远程仓库
如果没有本地仓库:
# 初始化本地仓库
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
仓库,并且基于初始代码默认执行了一次提交。
git remote add origin https://github.com/lipengzhou/toutiao-publish-admin.git
# -u 就是记住本次推送的信息,下次就不用写推送信息了,可以直接 git push
git push -u origin master
(3)之后如果有代码变动需要提交
git add
git commit
# 推送到远程仓库
# 推送的时候如果不改变远程仓库和分支的话就直接
git push
# 如果推送的远程仓库或是分支改变了
$ git push -u 远程仓库 分支名称
扩展:管理远程仓库地址信息
# 查看使用帮助
git remote --help
# 查看所有的远程仓库信息
git remote -v
# 添加远程仓库地址信息
git remote add 名称 远程仓库地址
# 删除指定的远程仓库信息
git remote remove 名称
# 修改远程仓库地址信息
git remote set-url 远程仓库地址名称 新地址
调整初始目录结构
这里主要就是下面的两个工作:
-
删除初始化的默认文件
-
新增调整我们需要的目录结构
1、将 App.vue
修改为:
<template>
<div id="app">
<h1>黑马头条内容发布系统</h1>
<!-- 路由出口 -->
<router-view/>
</div>
</template>
<script>
export default {
name: 'App'
}
</script>
<style lang="less"></style>
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
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 代码风格。下面是它的一些具体规则要求:
JavaScript Standard Style 规范说明
建议把:https://standardjs.com/rules-zhcn.html 看一遍,然后在写的时候遇到错误就查询解决。
-
使用两个空格 – 进行缩进
-
字符串使用单引号 – 需要转义的地方除外
-
不再有冗余的变量 – 这是导致 大量 bug 的源头!
-
行首不要以
(
,[
, or ``` 开头 -
这是省略分号时唯一会造成问题的地方 – 工具里已加了自动检测!
-
关键字后加空格
if (condition) { ... }
-
函数名后加空格
function name (arg) { ... }
-
坚持使用全等
===
摒弃==
一但在需要检查null || undefined
时可以使用obj == null
。 -
一定要处理 Node.js 中错误回调传递进来的
err
参数。 -
使用浏览器全局变量时加上
window
前缀 -
document 和 navigator 除外
-
避免无意中使用到了这些命名看上去很普通的全局变量,
open
,length
,event
还有name
。 -
查看更多 – 为何不试试 standard 规范呢!
说了那么多,看看这个遵循了 Standard 规范的示例文件 中的代码吧。或者,这里还有一大波使用了此规范的项目 代码可供参考。
如何解决代码规范错误
网络异常,图片无法展示
|
如果你不认识命令行中的语法报错是什么意思,你可以根据错误代号去 ESLint 规则列表中查找其具体含义。
什么是错误代号?
网络异常,图片无法展示
|
括号中的就是错误代码。
semi
keyword-spacing
space-before-function-paren
打开 ESLint 规则表,使用页面搜索(Ctrl + F)这个代码,查找对该规则的一个释义。
网络异常,图片无法展示
|
例如我通过页面页面查找
space-before-function-paren
规则代号的释义。
关于 Vue.js 代码规范
非强制要求,但是建议按照一定格式来写。
参考:官方风格指南。
Element 组件库
Element 介绍
Element 是饿了么前端团队开发的一个基于 Vue.js 的桌面端组件库,它提供的组件非常丰富,不仅功能强大,而且简单易用。
Element 非常的流行,大多数基于 Vue.js 开发的管理系统都会使用到它。
-
GitHub 仓库:https://github.com/ElemeFE/element
-
目前已有 44.8k 的 Star 了
导入到项目中
1、安装
npm i element-ui
2、在 main.js
中配置 element 组件库
/**
* 项目的启动入口
*/
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 单独封装一个模块用于项目中的请求操作。
/**
* 基于 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: ''
// })