WinForm实现同一台电脑两个程序间的TCP通信

设想一个场景：同一台电脑上，两个Windows程序想要互相“说说话”。对，不经过服务器，不依赖互联网，就那么在本地，程序A和程序B之间建立一条专属通信链路。这事儿听起来有点底层，但用WinForm + TCP协议，几段代码就能搞定。下面这套方案，说白了就是给出一套服务端、一套客户端，复制粘贴就能跑，无论是学习还是快速搭建demo，都够用了。

一、前期准备（VS2022环境）

打开Visual Studio 2022，直接创建两个「Windows 窗体应用 (.NET Framework)」项目。命名要清晰，方便区分：

• 项目1：TCPServer（程序A，负责监听，扮演服务端角色）
• 项目2：TCPClient（程序B，负责主动连接，扮演客户端角色）

这里有个小提示：两个项目的.NET Framework版本最好保持一致，建议选4.7.2或更高，能省去一些意料之外的兼容性麻烦。

二、程序A（TCP监听服务端）完整实现

2.1 界面设计（简易版）

在TCPServer项目的Form1窗体上，不需要花哨，拖拽三个控件就足够：

• 一个TextBox控件：命名为txtMsg，设置Multiline = true（支持多行显示），Dock = Top（停靠在顶部），用来显示服务端的监听状态和接收到的消息。
• 两个Button控件：一个叫btnStart，文字设为「启动监听」；另一个叫btnStop，文字设为「停止监听」。简单直接，运行起来一目了然。

界面效果大致是：顶部是消息显示区域，下方两个按钮并排。作为demo，足够了。

2.2 完整代码（直接复制覆盖）

双击Form1窗体进入代码编辑器，把默认代码全部删掉，复制下面这段就行。注释写得比较细，关键步骤都标清楚了：

using System;
using System.Net;
using System.Net.Sockets;
using System.Text;
using System.Threading;
using System.Windows.Forms;

namespace TCPServer
{
    public partial class Form1 : Form
    {
        // TCP监听套接字——服务端的核心，负责等待客户端来敲门
        private TcpListener tcpListener;
        // 客户端连接套接字——一旦有客户端连上来，就靠它来收消息
        private TcpClient clientSocket;
        // 监听线程——监听操作是阻塞的，必须放在后台，否则界面就卡死了
        private Thread listenThread;
        // 服务端IP和端口：127.0.0.1是本地回环地址，端口8888可以自定义，但要和客户端保持一致
        private readonly string ip = "127.0.0.1";
        private readonly int port = 8888;

        public Form1()
        {
            InitializeComponent();
            // 别忘记绑定窗体关闭事件，关闭时释放资源，这是好习惯
            this.FormClosing += Form1_FormClosing;
        }

        // 点击「启动监听」
        private void btnStart_Click(object sender, EventArgs e)
        {
            // 开一个后台线程去执行监听，主线程才能继续响应用户操作
            listenThread = new Thread(StartListen);
            listenThread.IsBackground = true;
            listenThread.Start();
            AppendMsg("服务端已启动监听：" + ip + ":" + port);
        }

        // 核心方法：启动TCP监听，等待客户端连接
        private void StartListen()
        {
            try
            {
                tcpListener = new TcpListener(IPAddress.Parse(ip), port);
                tcpListener.Start();
                AppendMsg("等待客户端连接...");

                // 死循环监听——这是阻塞的，所以必须在线程里跑
                while (true)
                {
                    // 蹲守到第一个愿意连上来的客户端
                    clientSocket = tcpListener.AcceptTcpClient();
                    AppendMsg("客户端已连接！");

                    // 为这个客户端开一个新线程去收消息，方便以后扩展多客户端
                    Thread receiveThread = new Thread(ReceiveMsg);
                    receiveThread.IsBackground = true;
                    receiveThread.Start(clientSocket);
                }
            }
            catch (Exception ex)
            {
                AppendMsg("监听异常：" + ex.Message);
            }
        }

        // 接收客户端发来的消息
        private void ReceiveMsg(object obj)
        {
            TcpClient client = (TcpClient)obj;
            NetworkStream stream = client.GetStream();

            try
            {
                byte[] buffer = new byte[1024];
                int len;

                // 循环读取，直到客户端断开
                while ((len = stream.Read(buffer, 0, buffer.Length)) > 0)
                {
                    string msg = Encoding.UTF8.GetString(buffer, 0, len);
                    AppendMsg("客户端说：" + msg);
                }
            }
            catch
            {
                AppendMsg("客户端断开连接");
            }
        }

        // 点击「停止监听」
        private void btnStop_Click(object sender, EventArgs e)
        {
            tcpListener?.Stop();
            clientSocket?.Close();
            AppendMsg("服务端已停止监听");
        }

        // 窗体关闭时，一定要记得清理资源
        private void Form1_FormClosing(object sender, FormClosingEventArgs e)
        {
            tcpListener?.Stop();
            clientSocket?.Close();
        }

        // 跨线程安全更新界面——后台线程不能直接动控件，必须走Invoke
        private void AppendMsg(string msg)
        {
            if (txtMsg.InvokeRequired)
            {
                txtMsg.Invoke(new Action(() =>
                {
                    txtMsg.AppendText(DateTime.Now.ToString("HH:mm:ss ") + msg + Environment.NewLine);
                }));
            }
            else
            {
                txtMsg.AppendText(DateTime.Now.ToString("HH:mm:ss ") + msg + Environment.NewLine);
            }
        }
    }
}

三、程序B（TCP客户端）完整实现

3.1 界面设计（简易版）

在TCPClient项目的Form1窗体上，需要四个控件：

• 一个TextBox控件：命名为txtMsg，设置Multiline = true、Dock = Top，用来显示连接状态和收发消息的记录。
• 一个TextBox控件：命名为txtSend，单行即可，用来输入要发送的消息。
• 两个Button控件：btnConnect文字设为「连接服务端」，btnSend文字设为「发送消息」。

布局很直观：顶部是消息框，中间是输入框，下方两个按钮并排。

3.2 完整代码（直接复制覆盖）

同样，进入代码编辑器，删掉默认内容，复制以下完整代码。注释风格和服务端保持一致，一一对应：

using System;
using System.Net.Sockets;
using System.Text;
using System.Threading;
using System.Windows.Forms;

namespace TCPClient
{
    public partial class Form1 : Form
    {
        // TCP客户端套接字——用来连接服务端并发送数据
        private TcpClient clientSocket;
        // 服务端IP和端口，必须和服务端完全一致
        private readonly string serverIp = "127.0.0.1";
        private readonly int serverPort = 8888;

        public Form1()
        {
            InitializeComponent();
            this.FormClosing += Form1_FormClosing;
        }

        // 点击「连接服务端」
        private void btnConnect_Click(object sender, EventArgs e)
        {
            try
            {
                clientSocket = new TcpClient();
                clientSocket.Connect(serverIp, serverPort);
                AppendMsg("成功连接到服务端！");

                // 开个线程等着收服务端发来的消息（虽然本例暂时只用客户端发，但双向通信的架子已经搭好了）
                Thread receiveThread = new Thread(ReceiveMsg);
                receiveThread.IsBackground = true;
                receiveThread.Start();
            }
            catch (Exception ex)
            {
                AppendMsg("连接失败：" + ex.Message);
            }
        }

        // 接收服务端消息（预留功能，方便以后扩展）
        private void ReceiveMsg()
        {
            try
            {
                NetworkStream stream = clientSocket.GetStream();
                byte[] buffer = new byte[1024];
                int len;

                while ((len = stream.Read(buffer, 0, buffer.Length)) > 0)
                {
                    string msg = Encoding.UTF8.GetString(buffer, 0, len);
                    AppendMsg("服务端说：" + msg);
                }
            }
            catch
            {
                AppendMsg("与服务端断开连接");
            }
        }

        // 点击「发送消息」
        private void btnSend_Click(object sender, EventArgs e)
        {
            // 先确认是不是真的连上了
            if (clientSocket == null || !clientSocket.Connected)
            {
                MessageBox.Show("请先连接服务端！");
                return;
            }

            try
            {
                string sendMsg = txtSend.Text.Trim();
                if (string.IsNullOrEmpty(sendMsg)) return;

                byte[] buffer = Encoding.UTF8.GetBytes(sendMsg);
                NetworkStream stream = clientSocket.GetStream();
                stream.Write(buffer, 0, buffer.Length);

                AppendMsg("你说：" + sendMsg);
                txtSend.Clear();
            }
            catch (Exception ex)
            {
                AppendMsg("发送失败：" + ex.Message);
            }
        }

        private void Form1_FormClosing(object sender, FormClosingEventArgs e)
        {
            clientSocket?.Close();
        }

        // 跨线程更新界面，逻辑和服务端完全一致
        private void AppendMsg(string msg)
        {
            if (txtMsg.InvokeRequired)
            {
                txtMsg.Invoke(new Action(() =>
                {
                    txtMsg.AppendText(DateTime.Now.ToString("HH:mm:ss ") + msg + Environment.NewLine);
                }));
            }
            else
            {
                txtMsg.AppendText(DateTime.Now.ToString("HH:mm:ss ") + msg + Environment.NewLine);
            }
        }
    }
}

四、运行步骤（超级简单，新手也能搞定）

先启动程序A（TCPServer）。点击【启动监听】，消息框会显示“服务端已启动监听：127.0.0.1:8888”和“等待客户端连接...”。说明监听成功了。

接着启动程序B（TCPClient）。点击【连接服务端】，如果一切顺利，消息框会显示“成功连接到服务端！”；与此同时，程序A的消息框也会弹出“客户端已连接！”。这一步，意味着通信链路已经搭好了。

测试消息：在程序B的输入框里打几个字，比如“Hello，服务端！”，然后点击【发送消息】。程序B会显示自己说了什么，程序A那边则会实时收到并显示“客户端说：Hello，服务端！”。

停止测试的时候，让程序A点一下【停止监听】就好。关闭两个程序时，资源会自动释放。

五、关键知识点说明（新手必看）

5.1 同一台电脑通信的核心

关键在于使用本地回环地址 127.0.0.1——无论电脑有没有联网，这个地址都有效。另外，服务端和客户端的端口必须完全一致。本例用的8888，完全可以换成其他端口，但建议选1024以上的，避免和系统预留端口冲突。

5.2 为什么要用线程？

TCP的AcceptTcpClient()（等待连接）和stream.Read()（读取数据）都是“阻塞方法”。如果直接放在主线程也就是界面线程里跑，界面会直接卡死——按钮点不了，输入框也点不了。所以必须把它们扔到后台线程里去。

5.3 跨线程更新界面

C# WinForm有个硬性规定：子线程不能直接修改主线程创建的控件。一旦违反，程序就会报错。所以要用Invoke方法来实现“线程安全的更新”。代码里的AppendMsg方法就是专门干这件事的。

5.4 资源释放

在窗体关闭或者停止监听时，调用Stop()、Close()释放TcpListener、TcpClient和NetworkStream，这是防止内存泄漏和程序异常的好习惯。

六、扩展功能（可选，按需扩展）

本文做的是“客户端发、服务端收”的单向通信，但代码结构已经为扩展留好了口子：

• 双向通信：在服务端也加一个输入框和发送按钮，复制客户端的发送逻辑，就能实现服务端向客户端发消息。
• 多客户端连接：服务端这边用集合存多个TcpClient对象，就能做出群聊效果。
• 发送文件：通过NetworkStream传输文件字节流，再加上文件选择和进度条功能即可。
• 心跳检测：定时发送心跳包，检测对方是否在线，防止连接意外断开。
• 消息加密：在发送字节流之前做一次加密（比如AES），能有效提高通信安全性。

七、常见问题排查

问题1：客户端连接失败，提示「无法连接到目标主机」？

解决：先检查服务端是不是已经启动了。再检查两边的IP和端口是不是完全一样。

问题2：消息发出去了，服务端却收不到？

解决：确认编码是不是一致（本例统一用UTF-8）。另外，检查客户端是否已经成功连接到服务端。

问题3：界面卡死了？

解决：确认监听和接收消息的操作是不是都放在后台线程里了，还要确认是否设置了IsBackground = true。

问题4：关闭程序后再次启动，提示「地址已在使用」？

解决：端口被占用了。换个端口试试，比如9999，同时确保服务端和客户端一致。或者等一两分钟，让操作系统自动释放端口。

总结

这两套代码各自独立，复制到项目里就能直接跑。它们实现了同一台电脑上两个WinForm程序之间的TCP基础通信，涵盖了线程安全、异常处理、资源释放这些核心细节。对于想入门TCP通信原理的人来说，是个不错的起点；如果手头正好有简单的项目需求，也能直接拿过去用。

至于双向通信、文件互传这些进阶功能，按照上面提到的思路去改就好，并不复杂。