react 如何升级
升级 React 项目的步骤
检查当前 React 版本
在项目根目录下的 package.json 文件中查找 react 和 react-dom 的版本号。也可以通过命令行运行以下命令查看:
npm list react
npm list react-dom
更新 React 和 React DOM
使用 npm 或 yarn 更新到最新稳定版本:
npm install react@latest react-dom@latest
# 或使用 yarn
yarn add react@latest react-dom@latest
处理破坏性变更
查阅 React 官方升级指南(如从 16.x 升级到 17+ 或 18+),特别注意以下常见变更:
- React 18 引入了新的根 API(
createRoot替代ReactDOM.render)。 - 生命周期方法的废弃(如
componentWillMount)。 - 严格模式的行为调整。
更新依赖库
确保第三方库(如 React Router、Redux)与新版 React 兼容。更新命令示例:
npm install react-router-dom@latest
# 或使用 yarn
yarn add react-router-dom@latest
测试与验证
运行测试并检查功能是否正常:
npm test
# 启动开发服务器验证
npm start
解决冲突与警告
根据控制台警告或错误信息调整代码,例如:
- 替换废弃的生命周期方法为
UNSAFE_前缀或改用 Hooks。 - 调整事件处理逻辑以兼容 SyntheticEvent 的变更。
清理与优化
移除未使用的依赖或迁移到推荐替代方案(如从 enzyme 迁移到 @testing-library/react)。
自动化升级工具
对于大型项目,可使用工具辅助升级:

npx react-codemod rename-unsafe-lifecycles
npx react-codemod update-react-imports
注意事项
- 逐步升级:从当前版本逐步升级到目标版本,而非直接跨越大版本。
- 备份项目:升级前提交代码到版本控制系统(如 Git)。
- 查看日志:阅读 React 官方博客的发布说明以获取详细变更列表。






