React源码调试与贡献：UMD构建失败问题求助

一、修正UMD构建命令 #

你当前执行的构建命令不符合React仓库的构建规则，替换为以下命令尝试：

yarn build react,react-dom --type=UMD

注意去掉路径里的/index，构建命令需要指定的是包名而非具体文件路径。执行完成后检查build文件夹，应该会生成umd目录，包含react.development.js、react-dom.development.js等预期文件。

二、直接调试源码（无需提前打包） #

如果你的核心需求是研究源码、断点调试，完全可以跳过打包步骤，使用React仓库自带的开发服务：

• 执行yarn start启动本地开发服务器
• 服务器启动后，打开浏览器访问指定端口（默认通常为3000）
• 打开浏览器开发者工具，在Sources面板中直接找到src目录下的React源码文件，设置断点即可调试

这种方式加载的是未打包的源码，支持实时修改与热更新，更适合源码研究和贡献开发。

三、排查构建异常的额外步骤 #

如果修正命令后仍有问题：

1. 检查Git分支：确保你在React仓库的稳定分支（如main或18.2.x），legacy文档的流程可能对应旧分支，切换分支后重新安装依赖：

   git checkout main
   yarn install --force
   

2. 查看构建日志：执行构建命令时，仔细观察终端输出的警告或错误信息，比如依赖缺失、入口文件不存在等问题，根据日志针对性修复。
3. 调整dev.html依赖路径：如果必须使用dev.html，打开文件后修改脚本引用路径，匹配你实际生成的构建产物位置（比如NODE类型生成的cjs文件，可将路径改为build/oss-experimental/react/cjs/react.development.js）。

内容的提问来源于stack exchange，提问作者The king Arthur