谷歌预览 Code Wiki：你能信任 AI 来记录你的代码库吗？

本文最初发布于 The Register。

谷歌预览了 Code Wiki，该 AI 项目旨在为代码库中的代码生成文档，并在每次代码变更后通过重新生成内容来完成更新。

该预览版收录了数百个开源项目的文档。即将推出的 Gemini CLI 扩展（谷歌人工智能助手）将支持在内部代码库上运行，但目前尚未公布定价信息。

官方公告仅简要介绍了 Code Wiki 的工作原理，至于预览版的具体功能，则需要开发人员自行探索。

在Hacker News的评论中，Mutable.ai 创始人 Omar Shams 指出，Code Wiki 是 Auto Wiki 的重构版本，后者是其公司被谷歌收购前开发的一个项目。

Code Wiki 专注于为代码库中的代码生成文档，而不是针对代码的输出生成文档。例如，我们看了该服务为微软 ASP.NET Core Web 平台生成的内容。虽然微软提供了详尽的 ASP.NET Core 使用文档，但面向项目贡献者的文档却不够完善，因此，Code Wiki 的工作可能会很有用。

Code Wiki 解释了 ASP.NET 分布式缓存的代码

Code Wiki 还提供了一个聊天用户界面，用于咨询与代码库相关的问题。我们曾询问，是否能用 Postgres 替代 SQL Server 作为 ASP.NET Core 的分布式缓存。Gemini 表示，“目前没有地方提及对 PostgreSQL 的直接支持或开箱即用的实现方案”。

然而，微软官方文档明确指出，“可通过 IDistributedCache 接口将 Azure Database for PostgreSQL 作为分布式缓存的后端存储使用。”Gemini 说对了一半——代码库中确实仅包含 SQL Server 和 Redis 的实现方案，但在这种情况下，可能会需要知识渊博的人类提供更准确的解答。

谷歌指出，阅读现有代码是软件开发中“最大、最昂贵的瓶颈之一”。对于新加入团队的开发者而言，这种感受尤为深刻。然而，AI 生成的文档是否是理想的解决方案，还有待观察。对于这一点，开发人员的看法也不一致。对于该预览版的发布，有一位开发人员表示，“至于整个代码库的文档，确实是我最不希望 AI 触碰的部分。它缺乏足够的上下文，没法拼凑出整个代码库的架构，而这个问题不是通过大量的工具调用就能解决的。”

另有一个人查看了它为 JavaScript 框架 Vue 生成的文档，他熟悉该框架。他的看法是，“看起来还不错”，但“那样的文档仍属于'有根据的猜测'，有着明显的大语言模型的特征，内容始终在过于模糊与过于具体之间摇摆，而且过于冗长，篇幅竟达到相关代码本身的五分之一。” 另一个问题是，Code Wiki 未明确说明 vuejs/vue 仓库已过时且两年前已停止维护；不过，当前版本的 vuejs/core 代码库另有一个独立的 Code Wiki 条目。

必须指出的是，Code Wiki 并非真正的维基，因为维基的本质在于协作性和开放性——允许用户共同编辑修改，而非堆砌大量自动生成的文本和图表。

关键问题在于，与阅读理解代码不同，AI 生成的文档缺乏权威性。Code Wiki 也明确指出，“Gemini 可能出错，请务必复核。”

代码变更时自动更新文档的做法有利有弊。保持文档实时更新当然有好处，但频繁变更可能会造成混乱。另一条评论说，“文档内容是否具有持久性？如果我正在阅读某部分文档，第二天发现内容完全不一样了，这对我的时间会是极大的浪费。”

谷歌并非首个尝试此类项目的公司。Devin 的DeepWiki采用了类似的理念，同样为开源代码库提供文档支持，且已支持私有代码库。

声明：本文为 InfoQ 翻译，未经许可禁止转载。

原文链接：https://www.theregister.com/2025/11/17/google_previews_code_wiki