net.Dial 是 Go 中建立 TCP 连接的基础方式，需正确传参、处理错误、关闭连接并配置超时；推荐使用 net.Dialer 结合 context 控制连接生命周期与重试。
使用 net.Dial 建立 TCP 连接是 Go 中最基础、最常用的网络编程方式，核心就一行代码：conn, err := net.Dial("tcp", "host:port")。关键在于理解参数含义、正确处理错误、及时关闭连接，并注意超时控制。
基本用法：拨号并发送数据
最简示例，连接本地 echo 服务（如 nc -l 8080）：
（注意：实际运行前请确保目标端口已监听）
conn, err := net.Dial("tcp", "127.0.0.1:8080")
if err != nil {
log.Fatal(err)
}
defer conn.Close()
, = conn.Write([]byte("Hello, server!\n"))
buf := make([]byte, 1024)
n, _ := conn.Read(buf)
fmt.Println("收到:", string(buf[:n]))
带超时的连接：避免永久阻塞
直接调用 net.Dial 没有超时，生产环境必须加控制。推荐用 net.DialTimeout 或更灵活的 net.Dialer：
立即学习“go语言免费学习笔记（深入）”；
-
net.DialTimeout("tcp", addr, 5*time.Second)—— 简单直接，只控制连接建立超时 - 用
net.Dialer可同时设置连接超时、KeepAlive、本地地址等：
dialer := &net.Dialer{
Timeout: 5 * time.Second,
KeepAlive: 30 * time.Second,
}
conn, err := dialer.Dial("tcp", "example.com:80")
处理常见错误
连接失败时 err 通常是 *net.OpError，可针对性判断：
-
errors.Is(err, syscall.ECONNREFUSED)—— 对方端口没开或服务未启动 -
errors.Is(err, context.DeadlineExceeded)—— 超时（需配合context使用） -
strings.Contains(err.Error(), "no route to host")—— 网络不可达（如防火墙、路由问题）
建议用 errors.Is 或 errors.As 做类型断言，而不是字符串匹配。
完整可靠示例（含上下文与重试）
实际项目中常需控制生命周期和失败重试：
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second) defer cancel()dialer := &net.Dialer{} conn, err := dialer.DialContext(ctx, "tcp", "api.example.com:443") if err != nil { log.Printf("连接失败: %v", err) return } defer conn.Close()
// 后续读写操作...
这样既防卡死，又便于上层统一取消。
基本上就这些。不复杂但容易忽略超时和错误分类，写 TCP 客户端时把 Dialer 和 context 配好，能避开 90% 的线上连接问题。
