下载安装

安装 Node.js

下载

官网：https://nodejs.cn，选择“长期支持版”。

配置环境变量

将 Node.js 安装目录添加到系统环境变量 path 中（可以参考其他教程）。

检查

安装完毕后，在命令行输入以下指令，输出版本号即为安装成功：

node -v

更改镜像源（淘宝源）

npm config set registry https://registry.npmmirror.com/

安装 yarn 和 tyarn

安装

npm install yarn tyarn -g

更改镜像源（淘宝源）

yarn config set registry https://registry.npmmirror.com/

安装 Ant Design Pro

官网：Ant Design Pro

初始化

npm i @ant-design/pro-cli -g

创建项目

名称：myapp，可更改

pro create myapp

安装依赖

cd myapp && tyarn

启动服务

npm run start

编译项目

npm run build

移除国际化（多语言）

npm run i18n-remove

执行完毕后，手动删除 src/locales 目录

更多使用和操作参考官方文档。

问题汇总

安装依赖报错

提示信息：

info There appears to be trouble with your network connection. Retrying...

原因：网络连接问题。

解决：

1. 更换镜像源；
2. 更换网络。

启动服务报错

提示信息：

Error: error:0308010C:digital envelope routines::unsupported

原因：NodeJs V17 版本发布了 OpenSSL3.0 对算法和秘钥大小增加了更为严格的限制，与 OpenSSL 不兼容导致的初始化失败，也就是 NodeJs 版本过高的原因导致了运行失败。

解决：

1. 降低 NodeJs 版本
2. 修改系统变量：添加系统变量：NODE_OPTIONS = --openssl-legacy-provider
3. 修改项目环境变量：

Unix (Linux, macOS, Git bash等)

export NODE_OPTIONS=--openssl-legacy-provider

Windows

set NODE_OPTIONS=--openssl-legacy-provider

PowerShell

$env:NODE_OPTIONS = "--openssl-legacy-provider"