常见问题

常见问题

Vibe Coding 是什么？

Vibe Coding 是一种用自然语言驱动 AI 参与软件开发的工作方式。本仓库强调的不是“让 AI 随便写”，而是用目标、约束、上下文、文档、测试、CI、Git 和复盘把 AI 输出固定成可维护工程产物。

这个仓库适合零基础吗？

适合。新手应先走 docs/getting-started/：先用网页 AI 作为零依赖启动器，再跑通网络环境、Codex CLI、开发环境和 Git 闭环。

为什么默认推荐先配置 Codex CLI？

因为 Codex CLI 跑通后，AI 不再只是聊天助手，而能读取文件、修改文件、执行命令、跑测试、提交 Git。这样后续 Git、Node.js、Python、依赖、编辑器和项目配置都可以交给本地 Agent 主动处理。

OpenCode、Claude Code、Cursor 还能用吗？

可以。Codex CLI 是本仓默认路线，OpenCode 是备选路线，Claude Code 和 Cursor 可按个人订阅、平台、模型和工作习惯选择。

AI 输出怎么防止幻觉？

不要相信 AI 的口头保证。把验收标准转成测试、CI、脚本、类型、schema、lint、检查清单或可审查 diff。

为什么 Wiki 不放全部正文？

主仓 docs/ 已经是线性总文档结构，Wiki 只做导航和摘要。这样避免两套长文档同时维护导致漂移。

如何贡献？

先看 贡献指南。核心要求是：基于 develop 分支修改，运行 make test，同步 README / AGENTS / 索引，并提交清晰 commit。

我应该先看 Wiki 还是主仓 docs？

先看 Wiki 建立导航感，再进入主仓 docs 看完整正文。Wiki 是入口层，主仓 docs 是事实源。

相关入口

• 知识库总索引
• 从零开始完整入门
• 开发流程
• Codex配置
• 从零开始：https://github.com/tukuaiai/vibe-coding-cn/tree/develop/docs/getting-started
• 开发流程：https://github.com/tukuaiai/vibe-coding-cn/tree/develop/docs/workflow
• 工程实践：https://github.com/tukuaiai/vibe-coding-cn/tree/develop/docs/references