文档高级
升级到2.2
当您从 2.1 迁移到 2.2 时，现有项目会发生哪些变化，以及如何处理。完整列表位于变更日志中。
uv add "nexy>=2.2" # or: uv tool upgrade nexynx buildnx test你可能需要改变什么
| 改变 | 这样做 |
|---|---|
.mdx 仅由 Vite 编译。 Python 编译器不再渲染它 |
将 React 或 Preact 保留在 useFF 中并安装 @mdx-js/rollup、remark-gfm 和 @mdx-js/react。没有组件的页面可以是 .md 文件 |
useBadge 消失了。 “Built with Nexy”标签不再存在 |
删除 nexyconfig.py 中的行。剩余的行将被忽略 |
nx check 不再编译 .mdx |
什么都没有： Vite 在构建时报告 MDX 错误 |
什么保持不变
- 您的路线、布局、操作和配置。
- 现有项目保留自己的起始页。新的入门设计仅适用于升级后创建的项目。
- 开发工具栏和
useDevTools。
2.2 中的新功能
- 代理文件。
nx new写入AGENTS.md、CLAUDE.md以及编码代理的技能。对于您已有的项目，请运行nx skills。它永远不会覆盖您编写的文件。参见编码剂。 - 持续运行的开发服务器。 当您的应用程序无法启动时，
nx dev会报告原因并等待下一次更改而不是退出。 - 为 Tailwind 或 UnoCSS 中的每个框架提供一个新的启动器，具有相同的页面和组件。
- UnoCSS 读取服务器项目中的
.nexy文件。如果将 UnoCSS 与.nexy页面一起使用，请添加 [疑难解答] 中所示的content块。
更正文档
三页纸说了一些代码不做的事情。如果您关注了他们，请检查您的文件：
.nexy组件将其子组件放置为<Slot />（大写 S），而不是<slot />。.nexy组件文件以 PascalCase 命名：它作为 Python 模块导入，因此连字符无法编译。- 对于
.mdx，当文件导入preact时，框架为 Preact，否则为 React。