admin-system

该项目为一个使用Ant Design Pro创建的后台项目模板。项目技术栈为 ES2015+、React、UmiJS、dva、g2 和 antd4+.

请注意，Ant Design Pro 支持范围为 IE10+，开发时需要确保 Node 10+环境。

一、常用方法

1、安装依赖

# 在项目根目录下执行
npm install

# 如果依赖安装较慢，可以使用淘宝镜像来安装
npm i --registry=https://registry.npm.taobao.org

2、本地开发

npm run start

3、正式打包

npm run build

4、检测代码风格

# 仅检查代码风格
npm run lint

# 检查代码风格的同时，自动修复部分可修复的问题
npm run lint:fix

5、跑测试用例

npm run test

二、技术栈介绍

ant-design-pro：一套可用于生产环境的一揽子管理系统模板。
react：用于构建用户界面的 JavaScript 库。
UmiJS：可拓展的企业级前端应用框架。
dva：基于 react 和 redux 的轻量级框架。
g2：是一套面向常规统计图表，以数据驱动的高交互可视化图形语法。
ant design：企业级产品设计体系。

三、常见问题

1、问题：安装依赖时提示Unexpected end of JSON input while parsing near

解决方案：先执行npm cache clean --force清除缓存，再重新npm install安装依赖。还不行的话尝试切换镜像地址进行安装，如：npm install --registry=https://registry.npm.taobao.org。还不行就换成用yarn安装。因为 ant design pro 本身模板没有带package-lock.json或者yarn.lock文件，所以不清楚是依赖没锁定导致我安装时最新的依赖彼此之间有冲突还是因为我用了 nvm 导致的，最终我是通过 yarn 来成功安装的。我把yarn.lock文件纳入了 git 版本控制，方便各位以后使用（不可用的话删掉即可）。

2、问题：执行yarn start后，打开的页面提示：Error: Cannot find module './locale'

解决方案：我遇到该问题时发现，ant design pro 的 package.json 文件中指定的 moment 依赖版本为 2.24.0 及以上，所以实际安装后在 yarn.lock 中安装的 2.25.1 版本。但是换成 2.24.0 版本的话就可以正常用了。具体方案是，先删除新版本的 moment 依赖（yarn remove moment），重新安装 2.24.0 版本的 moment 依赖（yarn add moment@2.24.0）。安装后查看 yarn.lock 文件，发现由于其他 npm 包的间接依赖设定，还是会有高版本的 moment 被安装。解决方案是在 package.json 文件中添加下述字段（效果是让间接依赖使用我们在 resolutions 里指定的版本），然后重新yarn install。

"resolutions": {
  "moment": "2.24.0"
}

四、配置/文件分析

tsconfig.json 文件分析

五、协议/License

无协议，可随意使用，但因使用造成的风险请自行承担。一旦使用本项目，即视为接受本条款。

Yakima-Teng / admin-system