UnoCSS 65.5 在 Astro 下报 ESM 错Node.js 23 环境三步修复指南【免费下载链接】unocssThe instant on-demand atomic CSS engine.项目地址: https://gitcode.com/GitHub_Trending/un/unocss当你在 Windows 上跑astro dev控制台突然抛出一个ERR_UNSUPPORTED_ESM_URL_SCHEME——这是 Node.js 原生的 ESMECMAScript ModulesES 模块加载机制加载器在拒绝一个盘符路径。问题卡在 UnoCSS 读取uno.config.ts那一步Node.js 23 改变了配置的加载链路。这篇复盘带你 30 秒确认是否命中同一个坑并给出三步修复路径。⚠️ 报错现场astro dev 直接抛 ERR_UNSUPPORTED_ESM_URL_SCHEMEWindows 终端里的完整报错长这样Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only URLs with a scheme in: file, data, and node are supported by the default ESM loader. On Windows, absolute paths must be valid file:// URLs. Received protocol d:此处放 Windows 终端完整报错截图你是不是也卡在这里项目代码一行没动只是 UnoCSS 升到 65.5.0 之后 dev 服务就起不来。配置文件写法可以对照 examples/astro/uno.config.ts本身没有任何问题——先别急着回滚。 30 秒确认是否命中同一个 Node.js 23 ESM 兼容问题三条快速判断全中就是同一个坑UnoCSS ≥ 65.5.0pnpm ls unocss看一眼Node.js 23node -v确认主版本Windows 系统报错里出现Received protocol d:这类盘符。Linux / macOS 上不会触发/开头的绝对路径 ESM 加载器本来就认。 为什么会这样Type Stripping 让动态 import 绕过 jiti整条因果链四步每步一句话UnoCSS 启动时由 unconfig一个轻量的配置文件加载包读取uno.config.ts过去 unconfig 用 jiti一个即时转译 TypeScript 的加载器加载配置路径转换由 jiti 内部兜底Node.js 23 默认开启 Type Stripping实验特性运行时剥掉 .ts 的类型标注后直接执行unconfig 因此改成直接动态 import绕开了 jitiD:\...\uno.config.ts这种 Windows 绝对路径被原样交给 ESM 加载器而它只认 file:// URL本地文件必须转成file:///...形式的地址看到d:协议立即报错。️ 修复路径按改动量从小到大排三条路最小改动.npmrc 一行配置 NODE_OPTIONS 禁用 Type Stripping急着出活先用组合拳止血项目根目录新建.npmrc写入一行shell-emulatortrue再把 package.json 的 dev 脚本改成dev: NODE_OPTIONS--no-experimental-strip-types astro dev关掉 Node.js 23 的实验性 Type Stripping 后unconfig 退回 jiti 的加载路径报错消失。适合谁当天要交付、不想等上游发版的团队。中等改动package.json 用 overrides 锁定 unconfig 版本这个修复已经落在 unconfig 的更新里——动态 import 前加了一段路径规范化逻辑把 Windows 路径转成合法的 file:// URL。你可以用 overridesyarn 用户用 resolutions强制依赖修复后的版本{ overrides: { unconfig: 修复后的版本号 } }适合谁不想让每个成员都配 NODE_OPTIONS、希望 CI 与本地行为一致的项目。等待上游unconfig 修复发布后直接升级最干净的路径是等 UnoCSS 发布包含修复的版本pnpm update后把上面两处临时配置清掉即可。Astro 侧接入方式本身没问题Astro 集成文档中的用法无需改动。适合谁不赶 deadline、追求干净依赖树的团队。带走三句话Windows 路径进入 ESM 动态 import 前必须先转成 file:// URL这是排查此类报错的第一判断。Node.js 大版本升级会改变 TS 配置的加载链路升版本前先验证 unconfig 这类配置加载依赖。临时用 NODE_OPTIONS 关实验特性止血长期靠上游发版别在业务代码里 hack 路径。【免费下载链接】unocssThe instant on-demand atomic CSS engine.项目地址: https://gitcode.com/GitHub_Trending/un/unocss创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考