转自：开源中国

时隔 2 年，React 的声明式路由组件 React Router 发布了第 5 个版本。

此版本侧重于稳定性和兼容性，带来了一系列改进与新特性，并且完全向后兼容 4.x。功能和改进很明显，但是没有破坏性变化，所以如果已经在使用 4.x 版本，则可以在不改变代码的情况下直接使用 v5 版本。

关于 React Router v5 有一个小插曲，其实开发团队原本只是计划发布 React Router 4.4 版本，但由于错误地使用了托字符 (^) —— 将依赖错误地写成 “react-router”: “^4.3.1”，导致报错。最后团队决定撤销 4.4 版本，直接改为发布 React Router v5。

react

react-router-dom 对 react-router 的版本依赖被写为 ^4.3.1，因此当 react-router 更新为 4.4 时用户依然可能会引用 4.3.x 的版本，而它们并不兼容。所以 react-router 开发组决定直接升级主版本为 5，以覆盖 ^ 的效果。

1
2
3
4
5
$ npm install react-router
# or
$ npm install react-router-dom
# or
$ npm install react-router-native

v5 中最重要的改进是对 >= 15 版本的 React 完全兼容，并对 React 16 提供了更好的支持。

升级了 React 的 context API；消除了所有 警告；对捆绑基础架构进行了彻底检查，并对发布的所有绑定包进行了全面测试。

还为生产引入了预优化的 build，可以不用在构建脚本中手动将 process.env.NODE_ENV 设置为“生产”，更重要的是不会将路由器构建为 build 的一部分，团队已经在开发和生产模式中处理了这个问题。

导入方式也因此需要改变：

1
2
3
4
5
6
/*Instead of*/
import Router from 'react-router/Router';
import Switch from 'react-router/Switch';

/*do*/
import { Router, Switch } from 'react-router';

目前仍然支持前一种风格，但会发出警告。

此外，v5 简化并自动化了发布过程，从现在开始能够更频繁、更可预测地发布。

新特性方面，此版本的一个主要新功能是能够在 中使用数组，简化了操作：

1
2
3
4
5
6
7
8
/*Instead of this*/
<Switch>
  <Route path="/users/:id" component={User} />
  <Route path="/profile/:id" component={User} />
</Switch>

/*you can now do this*/
<Route path={["/users/:id", "/profile/:id"]} component={User} />

还带来了一些 bug 修复，包括支持 中的 React.createRef，并支持在 中使用 React.forwardRef。

详情查看发布公告
https://reacttraining.com/blog/react-router-v5/