常见问题
新手最容易卡住的几件事。还没解决的，也可以带着具体报错去问 AI——用入门教程的调试模板把问题说清楚。
我该选哪个工具？
初次学习不用挑：直接用陶渊明 harness，图形界面、装好即用。 想用主流的四大工具（Claude Code / Codex / Cursor / opencode），看工具与资源与实战章的对比。
判断标准只有一条：先用一个能访问的工具，把完整流程走通一遍。 工具换来换去不产生任何产出。
完全不会编程，能学吗？
能。这一站就是为此写的：概念用中文讲，命令给可复制的模板，术语表随查。 但要认清边界：入门阶段可以“看懂 AI 在干什么”，一旦涉及账号、权限、付款、隐私、生产数据或长期维护，就需要补工程能力（见入门教程的说明）。
环境装不上 / 命令报错怎么办？
按顺序做三件事：
- 先看完整报错：错误类型 + 文件 + 行号，别只看最后一行。
- 原样把报错贴给 AI，用调试模板：现象 / 预期 / 复现步骤 / 证据 / 要求（先定位、别急改）。
- 缩小范围：把问题缩到最小可复现的一步；还不行就换一个问题描述再问。
不要做的：反复重装、复制网上不理解的命令、直接让 AI “随便修”。
AI 写的代码，我能信吗？
默认不能。 AI 会犯错，也会“看起来很确定地”编造不存在的接口。 所以要验收而不是相信：能复现的 bug 先写成测试，改动前看 diff、改动后亲自走一遍，接受前过一遍检查清单。这套流程见入门教程的检查清单与实战章的验证环节。
要不要花钱？
基础流程可以零成本起步：工具大多有免费额度，本站文档站这类项目本身也不花钱。 开始要注意两点：
- 额度/限流：用超了会变慢或收费，心里有数即可。
- 别把密钥写进代码：密钥只放环境变量，绝不提交到仓库。
学多久能做出东西？
零基础按学习路线图的 5 周计划，每周 5~8 小时，第 3 周就能有能跑的第一个版本，第 5 周能交付。 会编程的人，跳读两节核心内容 + 跑一遍实战，一两天即可上手。
密钥会不会被 AI 泄露？
风险主要来自你自己把密钥放错了地方，而不是 AI 主动泄露：
- 密钥只走环境变量，写进
.env； .env加进.gitignore，不提交；- 一旦发现泄露，立即在平台后台作废并重新生成，改代码没用。
这些术语要不要背？
不用。查得到就行——收藏术语表，读完一章扫一眼即可。