故障排除

常见的首次运行问题 — Docker、Node 版本、Yarn、依赖项。

• Docker 错误 — 在运行 yarn twenty docker:start 之前，请确保 Docker Desktop（或守护进程）已在运行。 错误消息会显示适用于你的操作系统的正确启动命令。
• Node 版本不正确 — 需要 24+。 使用 node -v 检查。
• 缺少 Yarn 4 — 运行 corepack enable。
• 依赖损坏 — rm -rf node_modules && yarn install。
• twenty-sdk 升级到 v2.8.0 后出现错误 — 在 v2.8.0 中，它从 dependencies 移动到了 devDependencies。 请参阅项目结构 → 依赖项。
• twenty build 会对 dependencies 下的 twenty-client-sdk 发出警告 — 它由 Twenty 在运行时提供，因此应与 twenty-sdk 一起移动到 devDependencies 中。 请参阅项目结构 → 依赖项。

卡住了吗？ 在 Twenty 的 Discord 上提问。