在全新的 Windows 平台环境中创建基于 Ant Design Pro 的项目,在安装依赖项时,最常遇到的错误一是在安装 node-gyp (一个用 Node.js 编写的跨平台的命令行工具,用于编译以 C/C++ 编写的 Node.js 原生插件模块)时系统未安装必需的 Windows 构建工具及 Python,这可通过执行以下命令来解决(注意需以管理员身份运行命令提示符等 Shell 工具):

npm install --global windows-build-tools

如果使用的是 Yarn,则执行以下命令:

yarn global add windows-build-tools

这将自动检测、下载及安装 Windows 构建工具及 Python:

npm install --global windows-build-tools
npm WARN deprecated request@2.88.2: request has been deprecated, see https://github.com/request/request/issues/3142

> windows-build-tools@5.2.2 postinstall C:\Program Files\nodejs\node_modules\windows-build-tools
> node ./dist/index.js



Downloading vs_BuildTools.exe
[>                                            ] 0.0% (0 B/s)
Downloaded vs_BuildTools.exe. Saved to C:\Users\xxxxxx\.windows-build-tools\vs_BuildTools.exe.

---------- Visual Studio Build Tools ----------
Successfully installed Visual Studio Build Tools.
------------------- Python --------------------
Python 2.7.17 is already installed, not installing again.

Now configuring the Visual Studio Build Tools..

All done!

+ windows-build-tools@5.2.2
added 144 packages from 98 contributors in 888.778s

如果已安装有 Python 3.x,在执行 node-gyp 构建脚本时,可能会报语法错误,可切换成 Python 2.x。

第二点就是在下载安装 Puppeteer 时,由于墙的原因,下载速度会非常慢,我们可以指定从淘宝镜像下载:

npm set puppeteer_download_host https://npm.taobao.org/mirrors
yarn config set puppeteer_download_host https://npm.taobao.org/mirrors