TcpClient 是 C# 中简化 TCP 通信的常用类，但需注意阻塞调用卡 UI、异步需配 CancellationToken、NetworkStream.Read 需自行处理粘包/半包、连接失败优先排查网络连通性、编码必须统一为 UTF8、务必显式释放资源。
TcpClient 是 C# 中最直接、最常用的 TCP 客户端实现方式，不用手动管理 Socket 底层细节，适合绝大多数局域网或稳定内网通信场景。但它不是万能的——阻塞式调用会卡 UI，异步不配 CancellationToken 容易泄漏任务，NetworkStream.Read 不处理粘包/半包就必然丢数据。
连接服务器时 TcpClient.ConnectAsync 报 “No connection could be made”
这基本是网络层连通性问题，不是代码写错了。先确认三点：
- 服务端确实在运行，且监听的是你填的
IPAddress和端口（比如127.0.0.1:60000，不是localhost或0.0.0.0） - 防火墙没拦截出站连接（尤其 Windows Defender 防火墙默认可能拦新程序）
- 如果连的是局域网 IP（如
192.168.x.x），确保客户端和服务端在同一子网；连127.0.0.1只能本机自连
别在 ConnectAsync 前手动 new TcpClient 再调 Connect —— 这种混用同步/异步的方式容易触发 InvalidOperationException。正确姿势是：
TcpClient client = new TcpClient();
await client.ConnectAsync("127.0.0.1", 60000);
NetworkStream.Read 读不到完整消息或卡住
这是新手踩坑最多的地方。NetworkStream.Read 是**阻塞式读取**，它只保证返回至少 1 字节（除非连接关闭），不保证一次读完你想要的整条消息。服务端发来 "Hello\r\n"，你用 Read(buffer, 0, buffer.Length) 可能只读到 "Hel"，下一次才读到 "lo\r\n" —— 这就是典型的半包。
- 永远不要假设一次
Read就拿到完整应用层消息 - 必须自己加协议头（比如前 4 字节存长度）或分隔符（如
\r\n），然后循环读、拼接、切分 - UI 线程里直接调
Read会彻底卡死界面；务必用ReadAsync+await，并配合CancellationToken
简单防卡死示例：
byte[] buffer = new byte[1024];
int totalRead = 0;
while (totalRead < expectedLength && !token.IsCancellationRequested)
{
int read = await stream.ReadAsync(buffer, totalRead, expectedLength - totalRead, token);
if (read == 0) break; // 对端关闭
totalRead += read;
}
发送中文或特殊字符后服务端收不到/乱码
根本原因是编码不一致。TcpClient 本身只传字节，Encoding.UTF8.GetBytes 和 Encoding.ASCII.GetString 混用就会丢字。ASCII 编码无法表示中文，一转就成问号或空字符串。
- 服务端和客户端必须使用**完全相同的 Encoding 实例**，推荐统一用
Encoding.UTF8 - 避免用
Encoding.Default—— 它依赖系统区域设置，Windows 中文版是 GB2312，但 .NET Core/.NET 5+ 默认是 UTF8，极易不一致 - 如果服务端是老旧设备（只认 ASCII 或 GBK），客户端也得配成对应编码，不能硬改
发送时：
byte[] data = Encoding.UTF8.GetBytes("你好，服务器");
await stream.WriteAsync(data, 0, data.Length, token);
断开连接后 TcpClient 对象没释放，内存持续上涨
TcpClient 包含非托管资源（socket 句柄），不显式 Dispose() 或 Close()，GC 不会立即回收，尤其在频繁重连场景下，句柄堆积会导致 SocketException: Too many open files。
- 必须在 finally 块或
using语句中释放：client?.Close()或client?.Dispose() - 别只关
NetworkStream——stream.Close()不等于client.Close()，后者才会真正释放 socket - WinForm/WPF 中，如果连接逻辑在按钮事件里，记得把
TcpClient成员变量置为null，否则引用残留也会阻碍 GC
安全释放模式：
try
{
await client.ConnectAsync(...);
// ...通信
}
finally
{
client?.Close(); // 或 client?.Dispose()
client = null;
}
真正难的从来不是“怎么连上”，而是连上之后怎么稳住：超时控制、重连退避、心跳保活、异常恢复、线程安全更新 UI —— 这些都不在 TcpClient 的职责范围内，得你一层层补全。
