goland远程调试文件服务前必须手动安装匹配go版本的dlv（如go 1.21+配dlv v1.22+），禁用编译优化（-gcflags="all=-n -l"），严格映射本地与远程路径，并注意http请求体读取顺序以避免eof错误。
GoLand 远程调试文件服务前必须装对 dlv
本地 GoLand 调试器不自带 dlv，远程服务器上必须手动安装匹配 Go 版本的调试器。Go 1.21+ 推荐用 dlv v1.22+，运行 dlv version 确认输出正常。如果版本不一致，会出现连接即断或 connection refused；用 sudo dlv 启动会因权限隔离导致 GoLand 认证失败。
上传下载 handler 必须禁用编译优化才能断点命中
GoLand 的断点在未优化二进制里才可靠。远程运行时务必加 -gcflags="all=-N -l" 参数，例如：dlv --headless --listen :2345 --api-version 2 --accept-multiclient --only-same-user=false -- ./server。否则 uploadHandler 或 http.ServeContent 内部调用栈可能被内联，断点悬空、变量不可见。
文件路径映射错会导致上传/下载逻辑调试失效
GoLand 的 Deployment 配置和调试路径必须严格一致，否则你改的是本地代码，远程跑的是旧二进制：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在
Settings → Build, Execution, Deployment → Deployment → Mappings中，确认Local path（如./main.go）与Deployment path（如/home/user/myfilesvc/main.go）完全对应，结尾斜杠不能多也不能少 - 远程工作目录需与本地一致，
dlv启动命令里的--wd参数要显式指定，比如--wd /home/user/myfilesvc - 如果上传目录是
uploads/，确保远程该路径存在且当前用户有读写权限：ls -ld uploads/ && ls -l uploads/
调试时别忽略 HTTP 请求体读取时机这个隐藏陷阱
上传 handler 里一旦调用过 r.Body.Read 或 io.Copy，再调用 r.ParseMultipartForm 就会报 http: multipart: Part.Read: EOF——但这个错误在调试中容易被断点跳过而没注意。正确顺序只能是：
- 先调
r.ParseMultipartForm(32 - 再调
r.FormFile("file") - 最后用
io.Copy写入磁盘
调试时可在 ParseMultipartForm 前加一行 log.Printf("body size: %d", r.ContentLength)，验证请求体是否为空或被提前消费。
