Ant Design Pro入门教程，安装，运行（V5 Typescript版）

【前言】

找了很多Admin模板，最后还是看中了AntDesignPro这个阿里巴巴开源的Admin框架，长这样（还行吧，目前挺主流的）：

官网地址：https://pro.ant.design/index-cn

该套模板是使用了React开发框架作为基础，AntDesign（蚂蚁金服开源UI组件库）作为UI库，集成了Dva，Umi，Mock等库，如果不是很了解这些内容，门槛还是比较高的，下面我们梳理一下从零开始运行起来这个项目的过程。

【准备环境】

1. node js 安装最新版即可
   
   我的nodejs版本 v12.18.3
2. npm npm服务器在国外，访问比较慢，可以更换成国内源：

npm config set registry https://registry.npm.taobao.org

当然也可以安装cnpm（采用的国内源），使用时需要npm命令的地方都换成cnpm

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

【开始整Antd Pro】

Ant Design Pro的安装方式有几种，可以自行选择：

1. git clone（稳定，没啥坑，速度偏慢github）

git clone https://github.com/ant-design/ant-design-pro.git
cd　ant-design-pro
npm install
npm start

2. 官网推荐的方法

新建一个空的文件夹作为项目目录，并在目录下执行：

npm create umi

然后等待安装依赖，完毕后会提示选择模板，我们选择第一个 ant-design-pro（完整的pro模板）：

 Select the boilerplate type (Use arrow keys)
❯ ant-design-pro  - Create project with an layout-only ant-design-pro boilerplate, use together with umi block.
  app             - Create project with a simple boilerplate, support typescript.
  block           - Create a umi block.
  library         - Create a library with umi.
  plugin          - Create a umi plugin.

选择模板后，会弹出选择版本，我们选择v5（v5默认是typescript版本，也是antd pro的最新开发模式，v4可以选择javascript/typescript两种版本，如果不想用typescript方式，可以选择v4，然后再选择javascript即可。

Ant Design Pro 脚手架将会自动安装...

运行Antd Pro（Ant Design Pro，下文简称Antd Pro）

安装教授架完毕后，执行命令:

npm install
npm start

如果重试几次还报错，可以考虑换cnpm试试，我这就cnpm好使

cnpm install
cnpm start

等待webpack building完成

我们打开浏览器输入 http://localhost:8000 即可看到初始页面，大概长这样：

可能我们想参考官网展示的大量组件的代码，那么，我们如何得到官网这个较为完整的效果呢？

其实很简单，在启动的时候，我们加个参数 fetch:blocks ，会自动安装完整的组件到我们的代码中

cnpm run fetch:blocks

输入命令会执行漫长地下载安装过程，安装完毕后，重新启动即可

【简单介绍一下】

目录结构

Antd Pro 已经为你生成了一个完整的开发框架，提供了涵盖中后台开发的各类功能和坑位，下面是整个项目的目录结构。

├── config                   # umi 配置，包含路由，构建等配置
├── mock                     # 本地模拟数据
├── public
│   └── favicon.png          # Favicon
├── src
│   ├── assets               # 本地静态资源
│   ├── components           # 业务通用组件
│   ├── e2e                  # 集成测试用例
│   ├── layouts              # 通用布局
│   ├── models               # 全局 dva model
│   ├── pages                # 业务页面入口和常用模板
│   ├── services             # 后台接口服务，请求服务端接口的都放在这里
│   ├── utils                # 工具库
│   ├── locales              # 国际化资源
│   ├── global.less          # 全局样式
│   └── global.ts            # 全局 JS
├── tests                    # 测试工具
├── README.md
└── package.json

内置模板

- Dashboard
  - 分析页
  - 监控页
  - 工作台
- 表单页
  - 基础表单页
  - 分步表单页
  - 高级表单页
- 列表页
  - 查询表格
  - 标准列表
  - 卡片列表
  - 搜索列表（项目/应用/文章）
- 详情页
  - 基础详情页
  - 高级详情页
- 结果
  - 成功页
  - 失败页
- 异常
  - 403 无权限
  - 404 找不到
  - 500 服务器出错
- 个人页
  - 个人中心
  - 个人设置
- 图形编辑器
  - 流程图编辑器
  - 脑图编辑器
  - 拓扑编辑器
- 帐户
  - 登录
  - 注册
  - 注册成功

代码结构基本长这样

模板内建了模拟数据、HMR 实时预览、状态管理、国际化、全局路由等等各种实用的功能辅助开发，想要了解更多可以访问官网（目前比较粗糙）

官网地址：https://pro.ant.design/index-cn