g.4方法⏱ 约 5 分钟

设计数据结构

想清楚"数据长什么样",代码才好写

🔎 最后验证 2026-05📚 来源:《AI编程实战三卷书》卷一、通用计算机常识🧰 Claude Code✅ 56 人学过👁 134 次阅读

为什么学这个

动手写功能前,先想清楚一件事:你的数据长什么样?一个任务有哪些字段?一局游戏的状态怎么表示?数据结构设计好,后面的功能就顺;设计乱,越写越拧巴。这是很多人跳过、却最该花时间的一步。

💡 打个比方

数据结构就像整理收纳前先想好用什么盒子:袜子一个格、文件一个夹、杂物一个箱。盒子分对了,东西好放也好找;一开始乱塞,以后整理起来要命。先设计数据,就是先想好"用什么盒子装什么"。

设计数据结构,就是回答:我要存哪些信息?每条信息有哪些字段?
- 待办清单:一个任务 = { 内容, 是否完成, 创建时间 },整个清单 = 一组任务的数组
- 井字棋:一局 = { 棋盘(9 格的状态), 轮到谁, 是否结束, 赢家 }
用上 P2 学的:这其实就是在设计你的 JSON 数据形状(4.8),如果用数据库就是设计表(4.9)
和 AI 一起设计,但你要看懂并拍板:字段够不够?命名一致吗?(P4 #14 防前后矛盾)
定下来后,可以写进 CLAUDE.md(P5 x.2),让后续开发都遵循同一套数据约定

❓ 测验

为什么动手写功能前要先设计数据结构?

⚠️ 避坑数据结构定了就尽量稳定,别频繁大改

数据结构是地基,一旦很多功能都依赖它,中途大改会牵一发动全身(P4 #19 回归)。所以前期多花点时间想清楚、和 AI 推敲几轮;真要改,也让 AI 评估"哪些地方会受影响"。当然也别追求一次完美——把核心字段定稳即可,细节可演进。

🤖 和 AI 设计数据结构(去真实环境)

我的项目是【项目】,核心功能是【功能】。请帮我设计数据结构:1) 需要存哪些信息、每条信息有哪些字段(给出 JSON 形状示例);2) 字段命名保持一致;3) 解释每个字段的用途。我看懂确认后,把这套数据约定写进 CLAUDE.md,后续开发都遵循它。

🔎 来源与核验· 1 条,点开核对

本节每个关键论断都对应一个可追溯的来源 —— 这是本课程"靠谱、不过时"的底线。

「先设计清晰、一致的数据结构再开发,可降低后续返工」

你会看到:只是给数据加了两个字段,却要回头动添加、渲染、勾选好几处代码——一个数据改动像涟漪一样扩散出去。

为什么:数据结构是地基,压在上面的功能越多,中途改动的代价越大。所以值得前期多花点时间和 AI 推敲字段(够不够、命名一致吗),把核心定稳——这不是拖延,是省下后面成片的返工。

✅ 小结

数据结构定好了,地基稳了。接下来两节进入最有成就感的部分——实现核心功能,让项目真正"活"起来。下一节开干第一个核心功能。

下一节 → 实现核心功能(一)

都看到这了，打个赏呗！