`docs-data` 在清理 `develop` 时编译失败: "nav.json 参照了 `core` 页面,但 docs.pages 中不存在该页面"

< ! -- 如果你是工人,就不要在这里打内线或打工 -- >

环境

• ** 包件版**:开发 ' 分支(在1230046b7 ' 承诺中测试)
• 操作系统:Windows 11
• 浏览器名称和版本:N/A,这是一个构建时间失败,而不是运行时间/浏览器问题

密码沙盒 N/A,这个错误发生在“docs-data”编译步骤(pnpm nx 运行@blueprintjs/docs-data:compile',也由pnpm dev'所触发)中,然后任何浏览器渲染才会发生。 代码Sandbox repro不适用;参见下面的复制步骤.

• 复制步骤

1. 清除新货并检查 " 开发 "
2. `pnpm安装'
3. pnpm nx运行@blueprintjs/docs-data:compile'(或pnpm dev',这取决于这项任务)

实际行为 编译步骤持续失败, 即使是在完全干净且局部变化为零的检出( 通过“ git status” 确认) :

[docs-data] 为库包汇编文档:核心,日期时间,日期时间2,图标,选择,表,实验室 [docs-data] 成功生成 npm-data.json 找到重复的页面"index";覆盖了先前的数据. 重命名标题或使用元数据参考'键来解析。 找到重复的页面"index";覆盖了先前的数据. 重命名标题或使用元数据参考'键来解析。 . . . . . . . . [警 您正在运行一个不支持的 TypeScript 版本 ! 如果TypeDoc崩溃,这就是原因. TypeDoc 支持 4.6, 4.7, 4.8, 4.9, 5.0, 5.1, 5.2, 5.3, 5.4 . . . . . . . . [docs-data] 生成 JSON docs 数据时的错误 : C:...\ packages\ docs-data\compile-docs-data.mts:52 丢出新错误( err) ; ^ 错误:错误:[docs-data]nav.json参考页面"core"在docs中不存在. 页次 at (C:...\ packages\ docs-data\compile-docs-data.mts:52: 11)

预期行为 docs-data'应在一个干净的develop ' 退出时成功汇编,因为这种块`pnpm dev'(完整的docs app取决于这项任务),使当地对变化的人工/浏览器核查变得困难。

可能的解决办法 两条可能的线索,虽然我挖得不够深 足以证实:

1. 重复的"Found reparate page""index";在相撞发生前为多套包重写了先前的数据"警告",说明有几套包在同一"index"键下生成了docs页. 到了"nav.json"翻出""核心"一页时,它可能已经被其中一对碰撞所覆盖.
2. 反弹目前解决了TypeScript 5.9.3,而`[警 则解决了TypeScript5.9.3。 您正在使用一个不支持的 TypeScript 版本运行 ! ' 消息显示 TypeDoc 只支持5.4 。 这种不匹配可能是促成因素。

在pnpm nx 重置 ' 和清理packages/docs-data/dist' 和其他生成的文物后确认可复制,因此这不是一个 stale-cache问题.