文档/故障排查
故障排查
装不上 / 跑不起来，按症状对号入座。还没找到的欢迎开 issue。
常见症状
- 装上了但样式全灰，按钮没颜色
- Tailwind 没扫到产物。确认
globals.css里@source的相对路径能从 css 文件定位到node_modules/@forge-ui-official/core/dist。monorepo 里路径可能是../../../node_modules/...。 Cannot find module "@forge-ui-official/core/styles.css"- 装的是太旧的版本（
0.1.0之前）。跑pnpm update @forge-ui-official/core，或检查package.json里版本是不是^0.1.0。 - React peer dep 警告
- 项目 React 版本 < 19。升到 19 或以上。Forge 里用了 React 19 的特性，18 以下用不了。