使用 yarn 的时候，遇到 Error [ERR_REQUIRE_ESM]: require() of ES Module 怎么解决？

晚上回到家，我打开自己的项目，执行：

cd HexoPress
git pull --rebase
yarn install
yarn dev

拉取在公司 push 的代码，然后更新依赖，最后开始今晚的开发时候，意外发生了，竟然报错了，明明在公司时候还好好的。到底怎么回事？

/Users/charles/Projects/HexoPress/node_modules/concurrently/node_modules/cliui/build/index.cjs:291
const stringWidth = require('string-width');
                    ^

Error [ERR_REQUIRE_ESM]: require() of ES Module /Users/charles/Projects/HexoPress/node_modules/string-width/index.js from /Users/charles/Projects/HexoPress/node_modules/concurrently/node_modules/cliui/build/index.cjs not supported.
Instead change the require of index.js in /Users/charles/Projects/HexoPress/node_modules/concurrently/node_modules/cliui/build/index.cjs to a dynamic import() which is available in all CommonJS modules.
    at Object.<anonymous> (/Users/charles/Projects/HexoPress/node_modules/concurrently/node_modules/cliui/build/index.cjs:291:21)
    at Object.<anonymous> (/Users/charles/Projects/HexoPress/node_modules/concurrently/node_modules/yargs/build/index.cjs:1:60678)
    at Object.<anonymous> (/Users/charles/Projects/HexoPress/node_modules/concurrently/node_modules/yargs/index.cjs:5:30)
    at Object.<anonymous> (/Users/charles/Projects/HexoPress/node_modules/concurrently/dist/bin/concurrently.js:30:33) {
  code: 'ERR_REQUIRE_ESM'
}

Node.js v20.8.1
error Command failed with exit code 1.

放狗在网上一搜，我发现这个问题并非我一个人遇到，竟然相当普遍。

其实我在公司，都还好好的，怎么可能回家就不对了呢？表面上看，这个问题的原因是在一个 Common JS 的代码里，用 require() 去引用了一个 ES Module 的类，这么操作是不支持的。推荐的解决办法是，将 require() 换成 import()。不用想，这当然是无稽之谈，很显然，出问题的代码根本就不是我写的，怎么可能去改呢？

是我引用的依赖，它的依赖，我的依赖我都不可能改，更别说依赖的依赖了。

比对整合了多篇帖子的内容后，我发现大家遇到这个错误是在不同的库，比如我这个场景是 concurrently 引用 string-width 的时候，网上还有很多人是引用 ts-node 的时候，别的也有。不过，不同场景遇到同一个错误，确实一点奇怪。终于，我发现，共性是大家都用了包管理器 yarn，有人说，将 yarn 升级到 3 就可以解决了。

我定睛一看，我 Node 版本是 20+，但是用的 yarn 竟然是 v1.22，为什么会用了一个这么老的 yarn 版本呢？这次我是真的乏力了，第一，我搞不清到底 yarn 有什么 bug 导致了这个问题，第二我搞不清为什么我会用这么旧一个 yarn 的版本。

解决方法很简单，就是升级 yarn，但是怎么升级呢？首先，你要确保你的 Node 环境的版本在 16.10+，然后：

yarn set version stable
yarn install

在项目里执行上面的命令，然后，你会发现升级完毕了。再次尝试，果然问题解决了。今天我执行完毕后，yarn 已经升级到了 v4.1.0 版本了。现在是 2024 年。

所以，如果你遇到了跟我一样的问题，可以先检查一下 yarn 的版本号是否过老？我前面也有文章提过，推荐初学者使用 npm 作为包管理器，至少我自己使用 npm 的时候，从没遇到过这个问题。确实是兼容性最好的包管理器。