Shiki.js 版本升级中的 WASM 导出变更解析

在 Shiki.js 语法高亮库从 1.15.2 升级到 1.17.5 版本的过程中，开发者们需要注意一个重要的 API 变更。这个变更涉及到 WASM 模块的导出方式，虽然未被明确记录在变更日志中，但对依赖该功能的项目会产生影响。

WASM 导出方式的变更

在 1.15.2 版本中，开发者可以通过具名导入的方式获取 WASM 实例：

import { getWasmInstance } from '@shikijs/core/wasm-inlined';

然而在 1.17.5 版本中，这个导出方式发生了变化，需要改为默认导入：

import { default as getWasmInstance } from '@shikijs/core/wasm-inlined';

变更背景与修复

这个变更最初被认为是重构过程中的无意行为。在社区反馈后，Shiki 团队在 1.17.6 版本中恢复了原有的导出方式，确保了向后兼容性。这种快速响应体现了开源社区对开发者体验的重视。

现代替代方案

值得注意的是，Shiki 在新版本中引入了更现代的引擎 API，开发者现在可以使用专门的 JavaScript 正则引擎：

import { createJavaScriptRegexEngine } from '@shikijs/engine-javascript';

这个新 API 提供了更清晰、更模块化的方式来处理语法高亮的核心功能，代表了 Shiki 架构的演进方向。

版本升级建议

对于正在升级 Shiki 版本的项目：

1. 如果升级到 1.17.5 版本，需要调整 WASM 导入方式
2. 升级到 1.17.6 或更高版本可以保持原有导入方式不变
3. 考虑评估新的引擎 API 是否更适合项目需求

这个案例也提醒我们，在依赖库升级时，除了查看官方变更日志外，还应该关注实际行为变化，特别是那些可能未被明确记录的底层实现调整。