更新 Docusaurus 到 3.6.0

Docusaurus 發布了 3.6.0 版本，這個版本主要更新了打包工具，大幅提升編譯速度。

但是我們在更新過程中又壞掉啦！

更新內容

如果你還不知道這件事情的話，可以先去看一下他們最新的部落格內容：

• Docusaurus 3.6

問題描述

更新本身沒有問題，但在這個版本中，Docusaurus 新增了一個特性，即可以在 config 中設定：

docusaurus.config.js

const config = {
  future: {
    experimental_faster: true,
  },
};

當我們把這個設定加入到我們的 docusaurus.config.js 檔案中，就會出現以下錯誤：

yarn run v1.22.22
$ docusaurus start
[INFO] Starting the development server...
[SUCCESS] Docusaurus website is running at: http://localhost:3000/
● Client ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■ (83%) sealing chunk ids
Segmentation fault (core dumped)
error Command failed with exit code 139.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

---

在看到這個錯誤的當下，我們其實是有點生氣的。

這裡就只給我們一個 Segmentation fault？是怎樣？要通靈嗎？

解決問題

我們在官方的 issue 中也沒有找到相關的解決方案，只好自己手動排查。

經過一番查找，我們發現這個問題在於 _category_.json 檔案中不能使用中文。

或者更正確的說，不能「特定」的中文字，至於具體是哪些字會導致錯誤，我們也不清楚。

例如，原本我們其中一個檔案是這樣的：

_category_.json

{
  "label": "元富證券",
  "position": 1,
  "link": {
    "type": "generated-index"
  }
}

把 元富證券 改成 中文 可以正常運行！

提示

一樣都是中文？為什麽這個可以，那個不行？

把 中文 改成英文，也可以正常運行了！

_category_.json

{
  "label": "English Label",
  "position": 1,
  "link": {
    "type": "generated-index"
  }
}

除此之外

我們意外地發現另外一個錯誤，就是新設定不能支援奇怪字元的檔案名稱。

例如，我們原本有一個檔案名稱是：Bézier，這裡面有個重音符號，就會導致錯誤。

移除重音符號，就可以正常運行了。

最後

這個特性我們最後決定不採用。

畢竟我們的網站也就這麼一丁點大，編譯速度並不是我們的瓶頸，但是這個特性卻要讓我們修改很多檔案。

還是改天再來看看吧！