常见问题与解决方案⚠️

  • 构建失败
    🔍 检查依赖项是否安装完整，使用 npm install 或 yarn install 重新安装依赖

    Build_Failure
    ⚠️ 确认环境变量配置正确，如 `NODE_ENV` 或 `API_KEY` [查看完整文档](/tools/autobuild/README)

  • 配置文件错误
    ✅ 使用 jsonlint 或 ymlint 验证配置文件语法

    Configuration_Error
    📝 检查 `.env` 文件编码是否为 UTF-8，避免特殊字符导致解析异常

  • 网络连接超时
    🌐 配置代理服务器：npm config set proxy http://your.proxy.server

    Network_Connection
    ⏱️ 优化 `package.json` 中 `scripts` 的执行顺序，减少阻塞操作

排查步骤建议🔍

  1. 查看构建日志中的错误代码（如 ERROR: 404 或 WEBPACK_COMPILER_ERROR）
  2. 在 ./build/logs/ 目录下定位具体失败的模块
  3. 通过 docker logs <container_id> 检查容器内部状态
  4. 使用 git diff 确认最近提交是否引入兼容性问题

扩展阅读📚

Build_Process