在分布式系统、微服务以及底层系统开发中，这三个词确实在某些语境下存在交集，但它们的侧重点和角色有着严格的学术和工程区别。

在非正式交谈中，它们有时会被混用（尤其是 Stub 和 Client），但在架构设计中，它们不是通用的。

---

Stub（存根）：通信的“替身”

Stub 主要出现在 RPC（远程过程调用） 语境中。

• 角色：它是远程服务在本地的一个代码代理。

• 功能：对程序员来说，调用 Stub 就像调用本地函数一样。Stub 负责将参数序列化（Marshaling），通过网络发走，并接收返回结果。

• 特点：Stub 通常是自动生成的（例如 gRPC 生成的 .pb.go 或 .java 文件）。它不具备复杂的业务逻辑，只负责“翻译”和“搬运”。

---

Client（客户端）：身份的“定义”

Client 是最宏观的概念，指代请求的发起方。

• 角色：相对于 Server 而言。
• 功能：Client 包含了业务逻辑。它可以调用 Stub 来发送请求，也可以通过 Agent 来管理任务。
• 关系：一个 Client 程序内部可能包含一个或多个 Stub。

---

Agent（代理/探针）：主动的“管理者”

Agent 通常指一个独立运行的实体，代表用户或另一个系统执行任务。

• 角色：它是主动的、持续运行的。
• 功能：在运维和 DevOps 中，Agent 常驻留在目标机器上，负责收集监控指标、执行指令（如 Zabbix Agent, Datadog Agent, 或 K3s 的 k3s agent）。
• 与 Stub 的区别：Stub 是被动调用的函数库；Agent 是主动干活的服务进程。

---

核心区别对照表

维度	Stub (存根)	Agent (代理)	Client (客户端)
存在形式	函数/类库（代码级）	独立进程（系统级）	应用程序（业务级）
主动性	被动（等待调用）	主动（持续运行/监控）	主动（发起业务请求）
生成方式	编译器/工具自动生成	手写或集成好的软件包	业务逻辑开发
主要任务	序列化与网络通信	任务执行、状态上报	实现业务目标

虽然定义不同，但在以下场景中，人们往往会混淆它们：

A. Client vs. Stub

当一个程序非常简单，除了发送 RPC 请求外几乎没有其他逻辑时，人们会直接把生成的 Stub 称为 “Client”。
* 例子：在 gRPC 中，你会看到代码里写 client := pb.NewGreeterClient(conn)，这里的 client 实际上就是一个 Stub。

B. Client vs. Agent
在分布式架构中，如果一个组件既负责向中心节点请求数据，又负责在本地执行任务，它既可以叫 Client 也可以叫 Agent。
* 例子：Docker 的客户端命令行工具叫 docker client，但在节点上负责管理容器的组件有时被称为 container agent。