标签 开源 下的文章

霸榜 GitHub 一周!Google 开源 ADK for Go,彻底终结 AI“炼丹”时代?

本文永久链接 – https://tonybai.com/2025/11/24/google-adk-go-in-action

大家好,我是Tony Bai。

上周,我花了一个下午,仅仅是为了让一个Python写的Agent能稳定地调用我Go服务里的一个简单函数。在那一刻,看着屏幕上纠缠的gRPC、Python虚拟环境和混乱的日志,我脑海里只有一个念头:这不对劲,这绝对不是软件工程该有的样子!

显然,不仅仅是我一个人在为此焦虑。

就在最近,一个名为 google/adk-go 的项目悄然开源,并迅速霸榜 GitHub Go 语言趋势榜长达一周之久! 全球的 Gopher 似乎都在用脚投票,表达着同一个渴望:我们受够了“炼丹”,我们要回归工程!

过去的一年,AI 的浪潮席卷了整个技术圈。我们 Gopher,作为构建云原生世界的中坚力量,看着 Python 社区在 AI 领域“杀”得热火朝天,心中或许都有一个共同的疑问:

“这场 AI 的盛宴,我们 Gopher 的主菜在哪儿?”

我们习惯了用 goroutine 优雅地处理并发,用 channel 安全地传递消息,用静态编译的单个二进制文件征服任何服务器。我们是天生的“工程师”,我们信奉的是可测试、可维护、可部署的软件工程哲学。

然而,当我们尝试踏入 AI Agent 的世界时,却常常感觉自己像一个闯入了“炼丹房”的“机械师”。面对那些需要反复“吟唱咒语”(调 Prompt)、结果飘忽不定的“丹炉”(模型),我们不禁会问:

  • 我的 Agent 行为不稳定,怎么写单元测试?
  • Prompt 稍微一改,整个“丹方”都可能失效,版本管理怎么做?
  • 我如何将这个“充满魔法”的 Python 脚本,与我现有的 Go 微服务体系优雅地集成,而不是变成一坨无法维护的“耦合怪”?

这些问题,不是因为我们不懂 AI,而是因为我们太懂工程。我们厌倦了“炼丹”式的不确定性,我们渴望一种能将 AI 的强大能力,用严谨的工程纪律约束起来的解决方案。

现在,Google 亲自下场,为我们递来了“工程图纸”。

Google ADK for Go:写给工程师的 AI Agent 开发框架

这个霸榜的项目,全称是 Agent Development Kit (ADK) for Go

这不是又一个“玩具”或“研究性”框架。从它的设计理念中,我看到了一个清晰而坚定的信号——AI Agent 开发,正在从“炼丹”式的“艺术创作”,全面进入“工程化”的“工业生产”时代。

而 ADK for Go 的核心哲学,与我们 Gopher 的信仰不谋而合,那就是——代码优先 (Code-First)

  • 你的 Agent,就是你的 Go 代码: 不再有晦涩的 YAML,不再有天书般的“链”,Agent 的所有逻辑、决策、工作流,都由你亲手编写的、地地道道的 Go 代码来定义。
  • 天生的可测试性: 你的 Agent 就是一个实现了 agent.Agent 接口的 struct。这意味着什么?你可以像测试任何 Go 代码一样,go test 走起!Mock 依赖、断言行为,所有你熟悉的工程实践,全部回归。
  • Git 即版本管理: Agent 的每一次进化,都是一次清晰的 git commit。Code Review、版本回滚,一切都尽在掌握。
  • 云原生无缝集成: 它就是一个标准的 Go 模块,可以被无缝地集成到你的 Gin/gRPC 服务中,打包成一个极小的 Docker 镜像,部署到任何 K8s 集群。

这就是为什么它能霸榜 GitHub 的原因——它不是在教你如何更好地“调优 Prompt”,而是在教你如何用坚实的工程代码,去彻底终结那个不可控的“炼丹”时代。

Google的adk-go,就是那座连接 Gopher 工程世界与 AI Agent 智能世界的桥梁。

和我一起,从零开始“造”一个真正的 AI Agent

坦白说,ADK for Go 刚刚推出,市面上的教程几乎一片空白。文档虽有,但如何将其与真实的工程场景结合,如何理解其设计背后的权衡,如何避开那些必将遇到的“坑”——这些都需要有人去探索,去趟路

所以,我决定做这件事。

我将以一个“学伴”“探索者”的身份,推出我的全新付费微专栏:

《Google ADK 实战:用 Go 构建可靠的AI Agent》

在这个专栏里,我不会扮演一个无所不知的专家。相反,我会将我从零开始学习、实践、踩坑、顿悟的全过程,毫无保留地分享给你。

我们将一起,手把手地、从一个空 main.go 文件开始,完成一次令人兴奋的创造之旅:

  • 第 1-2 讲:思维转变与灵魂注入
    我们将彻底理解“代码优先”的哲学,拆解adk-go,了解其中的概念、架构和核心组件,并亲手定义出第一个实现了 agent.Agent 核心接口的智能体。

  • 第 3 讲:为 Agent 插上“手臂”: 让你的Agent能调用任何Go函数,像操作自己的手脚一样自如
    我们将学会 ADK 的“魔法”函数 functiontool.New,将一个普通的 Go 函数,零成本地转化为 Agent 可用的工具。

  • 第 4 讲:赋予 Agent “双核记忆”
    我们将深入 session(短期记忆)和 memory(长期记忆),让我们的 Agent 能够理解上下文,并记起与你的历史交互。

  • 第 5 讲:从“单兵”到“军团”: 构建一个懂分工、会协作的Agent团队,自动化完成复杂任务
    我们将学习 workflowagents,通过编排多个专家 Agent,构建一个强大的“代码生成-审查-重构”自动化流水线。

  • 第 6 讲:从“原型”到“产品”
    我们将为 Agent 建立科学的评估体系,并最终将其打包成 Docker 镜像,部署到通用的 Kubernetes 环境中。

学完这个专栏,你将收获的,不仅是一个能跑起来的酷炫 AI 项目,更是一套可复用的、工程化的 AI Agent 构建方法论,以及在 AI 新浪潮中,属于我们 Gopher 的那份自信和底气。

加入这场 Gopher 的 AI 工程化之旅

这个微专栏,是我为你,也为我自己准备的一份“AI 时代 Gopher 生存指南”。它凝聚了我对 Go 工程哲学的理解,和我对 AI Agent 未来的全部热情。

微专栏共 6 篇深度长文,每一篇都是我亲手实践、细节满满的 step-by-step “航海日志”。

我没有设定一个高昂的价格,而是希望与更多志同道合的 Gopher 一起探索。所以,订阅这份专栏,仅需你一杯咖啡的诚意

花一杯咖啡的时间,你或许能得到片刻的清醒;而用同样的价格投入到这里,我希望能为你带来一次思维的升级技能的跃迁

点击这里,或扫描二维码,立即加入。

让我们一起,用代码,构建智能。

P.S. 如果你对 AI Agent、Go 语言或者这个微专栏有任何问题,欢迎在评论区留言,我们一起交流探讨!


还在为“复制粘贴喂AI”而烦恼?我的新专栏 AI原生开发工作流实战 将带你:

  • 告别低效,重塑开发范式
  • 驾驭AI Agent(Claude Code),实现工作流自动化
  • 从“AI使用者”进化为规范驱动开发的“工作流指挥家”

扫描下方二维码,开启你的AI原生开发之旅。


商务合作方式:撰稿、出书、培训、在线课程、合伙创业、咨询、广告合作。如有需求,请扫描下方公众号二维码,与我私信联系。

“可移植性”的隐藏成本:Go为何要重塑maphash并划定新的运行时边界?

本文永久链接 – https://tonybai.com/2025/09/23/go-maphash-portability-costs-and-runtime-boundaries

大家好,我是Tony Bai。

对于大多数Go开发者来说,标准库似乎是一个浑然天成的整体。我们理所当然地使用着fmt、net/http和encoding/json,很少去思考它们内部的依赖关系和架构边界。然而,在标准库光鲜的外表之下,一场关于其核心架构的深刻变革正在悄然发生,而hash/maphash这个看似不起眼的包,正处在这场变革的风暴中心。

最近,Go核心团队的技术负责人Austin Clements在2025年9月17日的提案审查会议中,将他在2025年6月提出的issue #74285的提案设置为“已接受”(Accepted)状态。该提案名为“maphash: drop purego version and establish stronger runtime boundary”,建议移除maphash包的purego实现,并为Go标准库建立一个更清晰的“运行时边界”。

在过去几个月中,Go团队与社区围绕maphash的讨论,以及与TinyGo、GopherJS等社区的精彩互动,揭示了在设计一个世界级标准库时,面临的关于可移植性、依赖管理和生态系统健康的深刻权衡。

在这篇文章中,我就和大家一起来探讨这一提案的背景、影响以及在实现过程中所面临的挑战。

问题的核心:maphash的两副面孔

maphash包的功能很简单:它暴露了Go语言内置map类型所使用的哈希函数。但为了支持不同的Go实现(如标准编译器gc、TinyGo、GopherJS),它内部存在两个截然不同的版本:

  1. gc版本 (运行时绑定,对应标准编译器gc):

    • 实现: 深度绑定Go gc运行时,直接使用编译器为map生成的、经过高度优化的哈希函数。
    • 依赖: 极其轻量,只依赖8个底层包。
    • 优点: 性能极高,依赖图谱干净。
  2. purego版本 (可移植):

    • 实现: 为了能在非gc环境(如TinyGo、GopherJS)中运行,它使用纯Go代码重新实现了一套哈希算法(wyhash),并通过reflect包来遍历类型,用crypto/rand生成随机种子。
    • 依赖: 这是一个灾难。purego版本引入了多达87个包的依赖,形成了一个庞大的依赖树。
    • 优点: 理论上具有更好的可移植性。

这个“可移植”的purego版本,正是问题的根源。一个本应是底层、基础的哈希库,却因为reflect和crypto/rand的引入,使其在依赖图谱中的位置变得异常之高。

“可移植性”的隐藏成本

这种臃肿的依赖关系带来了致命的副作用:标准库的底层包无法使用maphash

想象一下,如果internal/sync或unique这些极其底层的包想要使用maphash,它们就会被迫将reflect和crypto/rand等80多个重量级包引入到Go运行时的最底层。这将造成灾难性的依赖循环和二进制文件膨胀。

正如Austin Clements在提案中所说,purego版本的存在,使得maphash无法在它本该发挥最大价值的地方被使用,甚至在一些高层包中也引入了棘手的依赖问题。为了追求对非标准编译器的“开箱即用”支持,整个标准库的架构健康付出了沉重的代价。

提案:划定边界,回归简单

因此,Go团队提出了一个看似激进但实则回归本源的方案:移除purego实现,并正式声明maphash是“运行时的一部分”。

这也是Go团队的一种态度的表达:Go标准库需要一条清晰的界线,来区分哪些是可移植的、与运行时无关的代码,哪些是与特定工具链(如gc)紧密绑定的代码。

提案初期,Go团队提出的实现方案如下:

  • maphash的核心哈希逻辑保留在可移植的文件中。
  • 与gc运行时交互的“胶水代码”被隔离到一个单独的文件中,并使用//go:build gc标签进行标记。
  • 其他Go实现(如TinyGo)可以轻松地提供它们自己的“胶水代码”文件,来对接它们各自的运行时,而无需维护一个完整、复杂且依赖臃肿的purego版本。

但这个方案立刻引发了TinyGo和GopherJS社区核心维护者的深入讨论:

  • TinyGo的视角: TinyGo维护者表示,他们更倾向于使用//go:linkname来链接到运行时的内部函数。这种方式的“接口”更小、更稳定,比为每个包提供一个“胶水文件”更容易维护。
  • GopherJS的视角: GopherJS的维护者也指出了一个更棘手的问题:GopherJS的运行环境(JavaScript)不支持unsafe指针操作,因此一个纯Go的实现对他们至关重要。直接移除purego版本会给他们带来巨大的维护负担。

正是在这种建设性的讨论中,一个更完善、更具同理心的最终方案诞生了:

  1. 重构maphash: Go团队将重构maphash,使其运行时接口定义更清晰。
  2. 精简purego: 重写purego的哈希实现,用internal/reflectlite替换庞大的reflect,并移除crypto/rand依赖,从而大幅削减其依赖树。
  3. 移交所有权: 将这个精简后的、基于reflectlite的纯Go实现,移交给GopherJS项目自己维护
  4. 建立“防火墙”: 在Go标准库的依赖测试中,明确禁止reflectlite反向依赖maphash,从制度上杜绝未来可能出现的依赖循环。

小结

这场关于maphash的深刻讨论,最终以一个“皆大欢喜”的方案被接受。它不仅解决了Go核心团队的燃眉之急,也充分尊重了生态伙伴的需求。对于我们普通Gopher来说,这场“标准库的内科手术”带来了几点重要启示:

  • 没有免费的午餐:“可移植性”和“零依赖”等美好的设计目标,有时会带来意想不到的、系统级的隐藏成本。理解这些权衡,是做出优秀架构决策的前提。
  • 边界是清晰思考的产物:一个健康的系统,必然有清晰的边界。Go标准库正在通过这次重构,更严格地定义其内部的层次和依赖关系。我们在自己的项目中,也应该同样重视对模块和包的边界划分。
  • 开源的真正力量在于协作:这次提案的演进过程,完美地展示了一个成熟的开源社区是如何通过开放、理性的讨论,将一个单方面的决策,演进为一个凝聚了各方智慧、更具韧性的解决方案的。

最终,一个更健康、更易于维护、内部依赖更清晰的Go标准库,将使整个生态系统中的每一个人受益。这,或许就是这场看似不起眼的maphash重构,带给我们的最大价值。

资料链接:https://github.com/golang/go/issues/74285


你的Go技能,是否也卡在了“熟练”到“精通”的瓶颈期?

  • 想写出更地道、更健壮的Go代码,却总在细节上踩坑?
  • 渴望提升软件设计能力,驾驭复杂Go项目却缺乏章法?
  • 想打造生产级的Go服务,却在工程化实践中屡屡受挫?

继《Go语言第一课》后,我的《Go语言进阶课》终于在极客时间与大家见面了!

我的全新极客时间专栏 《Tony Bai·Go语言进阶课》就是为这样的你量身打造!30+讲硬核内容,带你夯实语法认知,提升设计思维,锻造工程实践能力,更有实战项目串讲。

目标只有一个:助你完成从“Go熟练工”到“Go专家”的蜕变! 现在就加入,让你的Go技能再上一个新台阶!


商务合作方式:撰稿、出书、培训、在线课程、合伙创业、咨询、广告合作。如有需求,请扫描下方公众号二维码,与我私信联系。

如发现本站页面被黑,比如:挂载广告、挖矿等恶意代码,请朋友们及时联系我。十分感谢! Go语言第一课 Go语言进阶课 AI原生开发工作流实战 Go语言精进之路1 Go语言精进之路2 Go语言第一课 Go语言编程指南
商务合作请联系bigwhite.cn AT aliyun.com
这里是 Tony Bai的个人Blog,欢迎访问、订阅和留言! 订阅Feed请点击上面图片

如果您觉得这里的文章对您有帮助,请扫描上方二维码进行捐赠 ,加油后的Tony Bai将会为您呈现更多精彩的文章,谢谢!

如果您希望通过微信捐赠,请用微信客户端扫描下方赞赏码:

如果您希望通过比特币或以太币捐赠,可以扫描下方二维码:

比特币:

以太币:

如果您喜欢通过微信浏览本站内容,可以扫描下方二维码,订阅本站官方微信订阅号“iamtonybai”;点击二维码,可直达本人官方微博主页^_^:
本站Powered by Digital Ocean VPS。
选择Digital Ocean VPS主机,即可获得10美元现金充值,可 免费使用两个月哟! 著名主机提供商Linode 10$优惠码:linode10,在 这里注册即可免费获 得。阿里云推荐码: 1WFZ0V立享9折!


View Tony Bai's profile on LinkedIn
DigitalOcean Referral Badge

文章

评论

  • 正在加载...

分类

标签

归档



View My Stats