谷歌预览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