如何本地运行ant-design官网？执行npm start出现报错如何解决？

问题根因 #

报错核心是版本不兼容：你拉取的antd master分支依赖的webpack版本过高，和文档构建工具bisheng内置的webpack v4版本存在API不兼容，导致构建进程直接崩溃，后续的EPIPE错误是进程异常退出后触发的进程通信报错，属于衍生问题。

解决方案 #

• 首先确认本地Node.js版本为官方要求的14.x版本，高版本Node会进一步放大依赖版本不兼容问题
• 若无需本地运行官方文档站点，仅调试组件代码，直接执行npm run dev即可，不需要走全量的文档构建流程
• 若确实需要本地运行文档站点，先删除现有依赖缓存和目录：

rm -rf node_modules package-lock.json yarn.lock

然后在package.json中添加版本锁定配置，使用npm的用户在package.json中新增overrides字段：

{
  "overrides": {
    "bisheng": {
      "webpack": "^4.46.0"
    }
  }
}

使用yarn的用户新增resolutions字段：

{
  "resolutions": {
    "bisheng/webpack": "^4.46.0"
  }
}

配置完成后重新安装依赖，再执行npm start即可正常启动。

内容的提问来源于stack exchange，提问作者Jeggy