用GoLand新建聊天室项目应按功能分层：根目录建cmd/server和internal/（含hub、ws子包），可选pkg/model；WebSocket跨域需配置Upgrader.CheckOrigin；并发map操作须用sync.RWMutex或channel保护；writePump需带缓冲channel并持续循环且recover panic。
如何用 GoLand 新建并组织聊天室项目结构
GoLand 本身不决定架构，但能帮你快速落地标准 Go 工程结构。别从 main.go 开始硬写，先按功能分层建目录：
- 根目录下建
cmd/server（放服务入口）和internal/（放核心逻辑） -
internal/hub：放Hub、Client结构体和广播逻辑 -
internal/ws：只放upgrader配置、upgradehandler 和读写 goroutine 封装 -
pkg/model（可选）：如果后续加用户系统，放Msg、User等结构体，字段必须首字母大写才能导出
GoLand 的 “New Go Module” 向导会自动初始化 go.mod，记得选对 Go 版本（1.21+ 更稳）。别把所有代码堆在 main.go 里——后期加私聊或房间隔离时，你会为没分层后悔。
WebSocket 连接升级时跨域失败怎么办
开发阶段最常卡在这步：Failed to establish WebSocket connection 或浏览器控制台报 Origin ... is not allowed。根本原因不是前端地址写错，而是 gorilla/websocket.Upgrader.CheckOrigin 默认拒绝非同源请求。
- 临时解决（仅开发）：设
Upgrader.CheckOrigin = func(r *http.Request) bool { return true } - 生产必须改回白名单：比如
return r.Header.Get("Origin") == "https://yourdomain.com" - 别漏掉
Upgrader其他关键配置：Upgrader.HandshakeTimeout设为 5 秒防慢连接拖垮服务，Upgrader.Subprotocols可留空，除非你用自定义子协议
GoLand 调试时，右键运行 main.go 后直接访问 http://localhost:8080 页面，再看浏览器 Network → WS 标签页是否显示 “Connected”。连不上就先查后端日志有没有 websocket: bad handshake —— 八成是 CheckOrigin 拦住了。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
为什么消息广播时 panic: concurrent map iteration and map write
这是新手高频崩溃点。错误信息明确指向：你在多个 goroutine 里同时遍历和修改同一个 map[*websocket.Conn]bool。GoLand 的 debugger 会停在 for range clients 那行，但根源不在循环本身，而在没做并发保护。
- 绝对不要在
Hub的广播方法里直接range clients并调conn.WriteMessage() - 正确做法：用
sync.RWMutex包裹读写，或更推荐——把客户端注册/注销操作全收口到一个hubgoroutine，用register/unregisterchannel 控制，避免 map 被多处触碰 - GoLand 的 “Find Usages” 功能可以快速定位所有修改该 map 的地方，检查是否都加了锁或走 channel
别依赖 defer mutex.Unlock() 就以为安全——如果 WriteMessage() 失败导致 goroutine 提前退出，锁可能没释放。实际代码里，clients map 只应在 hub 主循环中增删，其他地方只读（且加 RLock）。
前端连上 WebSocket 却收不到消息？检查 writePump 是否卡住
连接成功、服务端也往 client.send channel 发了消息，但浏览器没渲染——问题大概率出在 writePump goroutine 没启动，或启动后立即因 conn.WriteMessage() 错误退出又没 recover。
- 确保每个
Client初始化时，sendchannel 是带缓冲的：send: make(chan []byte, 32)，否则发第一条消息就阻塞 -
writePump必须用for循环持续从sendchannel 取数据，不能只取一次 - 加一行日志：
log.Printf("writePump for %s started", client.addr)，如果没打印，说明 goroutine 根本没启；如果只打印一次，说明它 panic 退出了
GoLand 的 “Attach to Process” 可以调试正在运行的服务，但更简单的是在 writePump 函数开头加 defer func() { if r := recover(); r != nil { log.Printf("writePump panic: %v", r) } }()——很多连接断开时 WriteMessage 报 write: broken pipe 就会 panic，不 recover 就静默退出。
