Go / 系统课时
用 TCP 跑通首个客户端
用 TCP 跑通首个客户端
这一节用一个可直接运行的 Go 程序完成一次 TCP 往返:客户端建立连接、发送字节、读取响应并关闭连接。程序内置最小测试服务端,因此不依赖前置课时,也能观察连接从创建到释放的完整路径。
学习目标
- 使用
net.Dial建立 TCP 连接,并识别连接成功与失败。 - 使用
Write与读取操作完成一次请求响应。 - 理解 TCP 是字节流,连接关闭与消息边界需要由应用主动处理。
从一次往返理解客户端职责
TCP 客户端拿到的核心对象是 net.Conn。Dial 成功后,连接会持续存在,客户端可以在同一连接上多次读写,直到任一端关闭或网络出现错误。一次最小往返通常经历建立连接、发送字节、等待响应、关闭连接四个阶段。

跑通最小 TCP 客户端
下面的程序先在本机启动一个只处理一次请求的测试服务端,再由客户端连接它。测试端只负责让示例自包含;真正需要关注的是客户端的 net.Dial、Write、io.ReadFull 和 Close。
go
package main
import (
"fmt"
"io"
"net"
)
func main() {
ln, err := net.Listen("tcp", "127.0.0.1:0")
if err != nil {
panic(err)
}
defer ln.Close()
serverDone := make(chan error, 1)
go func() {
conn, err := ln.Accept()
if err != nil {
serverDone <- err
return
}
defer conn.Close()
buf := make([]byte, 4)
if _, err := io.ReadFull(conn, buf); err != nil {
serverDone <- err
return
}
fmt.Printf("server received: %s\n", buf)
_, err = conn.Write([]byte("pong"))
serverDone <- err
}()
conn, err := net.Dial("tcp", ln.Addr().String())
if err != nil {
panic(err)
}
defer conn.Close()
if _, err := conn.Write([]byte("ping")); err != nil {
panic(err)
}
reply := make([]byte, 4)
if _, err := io.ReadFull(conn, reply); err != nil {
panic(err)
}
fmt.Printf("client received: %s\n", reply)
if err := <-serverDone; err != nil {
panic(err)
}
}预期输出
text
server received: ping
client received: pong127.0.0.1:0 让操作系统为测试服务端选择一个可用端口,所以示例不会依赖固定端口。客户端通过 ln.Addr().String() 获取实际地址,再发起连接。
读写边界与关闭时机
Write([]byte("ping")) 只是在 TCP 字节流中写入 4 个字节,并没有创建一个名为“ping”的消息。示例之所以能用 io.ReadFull,是因为双方提前约定响应恰好为 4 个字节。真实协议通常需要长度字段、分隔符或其他 framing 规则。
读取如果一直等不到足够字节会持续阻塞,因此线上客户端还应设置超时,例如通过 SetDeadline 限制一次交互的最长等待时间。无论正常结束还是提前返回,都应关闭连接;使用 defer conn.Close() 可以让最小示例在多条错误路径上保持资源释放一致。
按自己的节奏,确认真正理解。