项目升级到 React19 难度如何？生态初探：利用 react-markdown 实现代码高亮

经过前面几个实践案例的学习，我们都已经知道，React19 有非常吸引开发者的特性值得我们去升级。但是与此同时，我们也感受到了某些改动确实挺大的。因此在交流群里，大家会有一个比较明显的担忧，这种比较大的版本更新，是否会导致升级困难？

其实在官方文档中的升级指引中，有明确提到这个问题，开发团队预计这些重大更改不会影响到大多数程序。并且我们看到，react 删除的功能中，大多数都是几年前都已经标记弃用不建议大家使用的内容。

例如，class 语法中，曾经支持了字符串引用 ref。

// before
class MyComponent extends React.Component {
  componentDidMount() {
    this.refs.input.focus();
  }

  render() {
    return <input ref='input' />;
  }
}

这种使用方式因为存在多个缺点，在 2018 年 3 月（V16.3.0）中被标记为不推荐使用，直到现在才明确要删除代码。调整之后，开发者需要迁移到 ref 回调函数的使用。这个也并非新功能，而是一直都支持的写法，因此开发者有充裕的时间来解决这个问题。

// after
class MyComponent extends React.Component {
  componentDidMount() {
    this.input.focus();
  }

  render() {
    return <input ref={input => this.input = input} />;
  }
}

又例如，React19 决定要移出 ReactDOM.findDOMNode，这个 API 曾经在三方库中被大量使用，但是他已经在 2018 年 10 月被标记为废弃。由于他是一个性能较差，又容易受到重构影响，因此风险会比较大。

// Before
import {findDOMNode} from 'react-dom';

function AutoselectingInput() {
  useEffect(() => {
    const input = findDOMNode(this);
    input.select()
  }, []);

  return <input defaultValue="Hello" />;
}

在 React18 的版本中，提供了新的方案来替换该用法。

// After
function AutoselectingInput() {
  const ref = useRef(null);
  useEffect(() => {
    ref.current.select();
  }, []);

  return <input ref={ref} defaultValue="Hello" />
}

当然，其他的变化还有很多，我们就不一一列举，许多破坏性变更早在 React18 中就已经存在，因此对于长期维护的三方库而言，React19 的升级压力非常小。并且为了简化升级过程，React 发布了一个过渡版本 React 18.3，该版本功能与 React 18.2 相同，但是增加了对已弃用 API 代码的删除，并且调整了相关的警告。

目前，该过渡版本已经发布了刚好半个月，但已经被开发者大规模使用了。如下图所示，这个下载量，已经大概相当于 Vue 的整体使用水平了，所以整个行业对于 React19 的升级响应非常积极。

与此同时，我们还可以利用 react 团队之前发布的一个工具用于在代码中自动替换弃用的写法，他就是 react-codemod

因此总体来说，我们应该可以轻松的在 react19 中应用大多数目前仍然保持维护的三方工具库。为了验证我的猜想，我在 React19 项目中引入了许多我正在使用的三方工具库来尝试。这里就以 react-markdown 为例，跟大家分享一下在新项目中的运用情况。

react-markdown 是 react 生态中，一个非常好用 的 md 文件解析工具。依据这个工具，我们可以轻松创建一个 md 编辑器。

如果你要设计一个个人博客，并且需要展示技术类文章，这个工具可以很好帮助到你。我们这里以展示一个高亮代码块为目标，分享引入过程。

首先我们在项目中，引入 react-markdown

npm i react-markdown

有了这个之后，我们就可以在项目中解析一些简单的 md 格式。

例如，我们可以解析如下格式。

const input = '# This is a header\n\nAnd this is a paragraph'

在页面中引入 react-markdown

import Markdown from 'react-markdown'

然后直接在 JSX 中使用即可。

<Markdown>{input}</Markdown>

渲染结果如下

完了之后，有一些比较复杂的格式，react-markdown 可以引入不同的插件来支持。

例如，react-gfm，可以帮助我们解析列表等格式，如下所示：

const text2 = `A paragraph with *emphasis* and **strong importance**.

> A block quote with ~strikethrough~ and a URL: https://reactjs.org.

* Lists
* [ ] todo
* [x] done

A table:

| a | b |
| - | - |
`

安装插件

npm i remark-gfm

然后直接在组件中使用即可。

import remarkGfm from 'remark-gfm'

// jsx
<Markdown remarkPlugins={[remarkGfm]}>
  {text2}
</Markdown>

渲染结果如下。由于我没有引入 css，因此样式比较原始。

我们可以通过查看 html 标签来查看渲染结果。验证之后发现已经渲染成功。

当然，如果我们要渲染代码快，也需要引入特定的插件，我这里使用了 rehype-highlight

npm i rehype-highlight

安装好之后，我们可以专门在 .md 文件中编写好 md 内容，在 vite 项目中，可以直接通过如下方式引入 .md 文件

import code from './code.md?raw'

然后在页面组件中使用

import rehypeHighlight from 'rehype-highlight'

// jsx
<Markdown 
  remarkPlugins={[remarkGfm]} 
  rehypePlugins={[rehypeHighlight]}
>{code}</Markdown>

此时，我们观察页面，发现标签已经渲染好了

但是此时我们还没有样式文件。当然，我们可以直接自己根据对应元素中的 class 名来写样式。

由于设计能力有限，我一般引用别人已经设计好的样式文件。

如下这个网站收集了大量的高亮风格，我们直接复制代码使用即可。

https://highlightjs.tiddlyhost.com

我选择了一个，把他单独写在一个 css 文件中，并引入对应的组件。渲染结果如下

搞定！

end

总结

在我尝试了几个三方库之后，总体感受就是基本上都能正常在 React19 项目中使用，即使这些三方库还没有升级到 react19。当然我也把我某一个 React18 的项目升级到 React19，小幅度更改之后，也成功升级了。

因此我预计我们有希望在 react19 正式版本发布之后不久把项目正式升级。

但是，一个不太好的消息是，antd 由于使用了一些很早版本就弃用的方法，例如 findDOMNode，还有一些 React19 会弃用的 api, 例如 forwardRef，导致了 antd 一运行就各种报错。许多组件无法正常使用。这种就只能等 antd 适配进度了，他们应该会很快更新。