Go中搭建WebSocket环境需选用gorilla/websocket库，编写HTTP升级handler实现连接，前端用浏览器Console测试，注意跨域、握手失败和连接闪断等常见问题。
在 Go 中搭建 WebSocket 开发环境并不复杂，核心是选对库、写好服务端基础结构、配好依赖管理，并确保能跑通一个可交互的连接示例。下面分几步说清楚关键配置点。
选择主流 WebSocket 库
Go 官方标准库不直接支持 WebSocket，推荐使用社区成熟度高、维护活跃的 gorilla/websocket —— 它是目前最广泛采用的实现，文档全、示例多、兼容性好。
- 安装命令：
go get github.com/gorilla/websocket - 避免用已归档或长期未更新的替代库（如 websocket-go），容易踩兼容性坑
- 如果项目用 Go Modules，确保
go.mod中已正确记录该依赖
编写最小可用服务端
不需要框架，几行代码就能启动一个支持升级 HTTP 到 WebSocket 的服务：
- 用
http.HandleFunc注册一个路径（如/ws） - 在 handler 中调用
upgrader.Upgrade(r, w, nil)完成协议切换 - 升级成功后，通过
*websocket.Conn收发消息（WriteMessage/ReadMessage） - 别忘了设置超时、检查 origin（开发期可临时放宽）、关闭连接前调用
conn.Close()
前端快速验证连接
立即学习“go语言免费学习笔记（深入）”；
- 打开开发者工具 → Console，粘贴：
const ws = new WebSocket("ws://localhost:8080/ws"); ws.onopen = () => ws.send("hello"); ws.onmessage = e => console.log(e.data); - 观察服务端日志是否打印收到的消息，以及浏览器是否收到回包
- 若报错
Connection closed before receiving a handshake response，检查服务端是否真的调用了Upgrade，且路径和协议（ws://）匹配
调试与常见问题提示
开发初期最容易卡在这几个地方：
-
跨域被拦：本地前端页面用
file://打开会触发 CORS；建议用live-server或简单起个静态服务（go run -m http.FileServer） -
握手失败：检查响应头是否被中间件（如自定义中间件、gzip）篡改；
Upgrade必须是第一个响应，不能有其他WriteHeader或Write -
连接闪断：确认没漏掉
defer conn.Close()，且读写操作加了SetReadDeadline/SetWriteDeadline防止阻塞
基本上就这些。环境搭起来很快，重点是理解“HTTP 升级”这个机制，而不是堆功能。跑通一次收发，后面加广播、心跳、鉴权就顺了。
