粘包拆包实战环境搭建：Python环境准备、socket模块基础、创建TCP服务端与客户端

好，咱们正式开始动手。这一章的目标很明确——搭一个能跑、能复现粘包拆包现象的TCP实验环境。你想想看，如果连环境都跑不起来，后面那些抓包分析、协议设计全是纸上谈兵。

我个人习惯用Python来做这类实验。原因很简单：Python的socket模块足够底层，能让你看到TCP的原始行为；同时代码量又少，不会让你在语言细节上分心。我当年在调试一个嵌入式协议栈时，就靠Python搭的模拟环境定位了三个粘包bug——嗯，那会儿要是用C写测试代码，估计得加班到天亮。

Python版本与依赖

我建议你用Python 3.8及以上版本。3.6以下有些语法糖用不了，倒也不是不行，但没必要跟自己过不去。

组件	推荐版本	备注
Python	≥ 3.8	3.10/3.11 均可
socket模块	内置	无需额外安装
struct模块	内置	后面粘包拆包会用到

不需要装任何第三方库。Python标准库里的socket、struct、selectors就够用了。我曾经见过有人为了一个简单的TCP测试装了twisted——杀鸡用牛刀，还把自己绕晕了。

验证环境：打开终端，输入 python --version。如果看到版本号，就说明环境就绪。如果报错，去python.org下载安装包，记得勾选"Add Python to PATH"。

socket模块核心概念

socket说白了就是操作系统提供的一个网络编程接口。你往里面写数据，它帮你发出去；你从里面读数据，它把收到的内容交给你。TCP socket比UDP多了一层——连接。

这里有几个关键点，我当年踩过坑，给你提个醒：

socket类型：TCP用 SOCK_STREAM，UDP用 SOCK_DGRAM。别搞混，否则收不到数据别找我。
地址族：IPv4用 AF_INET，IPv6用 AF_INET6。现在99%的场景用IPv4就够了。
阻塞模式：默认是阻塞的。也就是说，recv() 没读到数据会一直等。后面我们会用到非阻塞或超时控制。

注意：TCP socket的 send() 并不保证一次就把所有数据发出去。它返回的是实际发送的字节数。如果你要发送一个1000字节的包，可能一次只发了600字节，剩下的400字节需要你手动重发。这就是后面粘包拆包问题的根源之一。

创建TCP服务端

先写服务端。代码不长，但每一步都有它的道理。

import socket

def start_server(host='127.0.0.1', port=8888):
    # 1. 创建socket对象
    server_sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    
    # 2. 设置地址重用，避免"Address already in use"
    server_sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
    
    # 3. 绑定地址和端口
    server_sock.bind((host, port))
    
    # 4. 开始监听，backlog表示最大挂起连接数
    server_sock.listen(5)
    print(f'[服务端] 监听 {host}:{port}')
    
    # 5. 接受客户端连接
    client_sock, client_addr = server_sock.accept()
    print(f'[服务端] 收到来自 {client_addr} 的连接')
    
    # 6. 接收数据
    data = client_sock.recv(1024)
    print(f'[服务端] 收到: {data}')
    
    # 7. 发送响应
    client_sock.send(b'Hello from server')
    
    # 8. 清理
    client_sock.close()
    server_sock.close()

if __name__ == '__main__':
    start_server()

这里有个细节：recv(1024) 的1024是缓冲区大小。如果客户端一次发了2000字节，服务端一次只能读到1024字节，剩下的会在内核缓冲区里等着。这就是拆包。如果客户端连续发了两个小包，服务端一次recv可能把两个包都读出来——这就是粘包。嗯，后面几章我们会专门对付它。

创建TCP客户端

客户端更简单，三步走：连接、收发、关闭。

import socket

def start_client(host='127.0.0.1', port=8888):
    # 1. 创建socket
    client_sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    
    # 2. 连接服务端
    client_sock.connect((host, port))
    print(f'[客户端] 已连接到 {host}:{port}')
    
    # 3. 发送数据
    client_sock.send(b'Hello from client')
    
    # 4. 接收响应
    data = client_sock.recv(1024)
    print(f'[客户端] 收到: {data}')
    
    # 5. 关闭
    client_sock.close()

if __name__ == '__main__':
    start_client()

    运行顺序：先启动服务端，再启动客户端。服务端调用 accept() 后会阻塞等待，直到客户端连上来。如果先启动客户端，它会因为找不到服务端而抛出 ConnectionRefusedError。

核心流程可视化

下面这张图把整个交互过程画清楚了。我建议你对照着代码看，能更快理解每个函数在流程中的位置。

避坑指南

环境搭好之后，有几个坑我帮你提前踩了：

端口被占用：如果运行时报 Address already in use，要么换端口，要么等两分钟让系统释放。我习惯在代码里加 setsockopt(SO_REUSEADDR)，这样能立刻重用端口。
防火墙拦截：Windows和macOS会弹窗询问是否允许Python通过防火墙。点允许。如果用的是云服务器，记得在安全组里开放对应端口。
粘包拆包还没出现？别急。单次收发看不出问题。下一章我们会连续发多个小包，或者发一个超大包，粘包拆包就现形了。

调试小技巧：在 send() 和 recv() 前后加 print() 打印时间戳和字节数。我当年排查一个线上问题时，就是靠这种"土办法"定位到是服务端recv缓冲区设得太小导致的拆包。

好了，环境已经就绪。服务端能收，客户端能发，TCP连接已经建立。接下来我们就可以在这个基础上，制造粘包和拆包现象，然后一步步把它们解决掉。

📚 课程目录

粘包拆包实战环境搭建：Python环境准备、socket模块基础、创建TCP服务端与客户端

Python版本与依赖

socket模块核心概念

创建TCP服务端

创建TCP客户端

核心流程可视化

避坑指南