必须先完整读取 multipart.file 内容再关闭，否则后续 io.readall 会返回 io.errclosedpipe；常见错误是 defer file.close() 放在读取前，正确顺序为：读取（如 io.readall）→ 处理 → file.close()。
上传后立刻读取文件内容失败？检查 multipart.File 是否已关闭
Go 的 http.Request 中通过 formFile 获取的 multipart.File 是一次性读取流，一旦调用 file.Close()（包括 defer），后续再 io.ReadAll(file) 就会返回空或 io.ErrClosedPipe。常见错误是把 defer file.Close() 放在读取前。
- 正确做法：先完整读取内容（如
io.ReadAll(file)或io.Copy到缓冲区），再file.Close() - 如果需多次读取（比如校验 + 格式化），建议直接转成
[]byte或bytes.Reader，避免依赖原始file句柄 - 注意：
file.Size()可能为 -1（未知大小），别盲目用make([]byte, file.Size())
JSON / CSV / Markdown 文件怎么统一做格式化？用类型探测 + 专用库处理
不能靠扩展名判断格式——用户可能传 data.txt 实际是 JSON；也不能硬编码解析逻辑。推荐先用 mimetype 和头部字节探测，再分发到对应处理器。
- 用
net/http.DetectContentType(buf[:min(512, len(buf))])初步判断 MIME 类型，但对无 BOM 的 UTF-8 文本效果有限 - 更可靠方式：尝试用
json.Unmarshal解析前 4KB，成功则走 JSON 格式化（json.Indent）；否则试csv.NewReader；再否则当纯文本做缩进/换行规整 - Markdown 推荐用
github.com/yuin/goldmark解析后重新渲染，避免正则误伤代码块 - 所有解析失败都应降级为原样返回（不 panic），并记录 warning 日志
大文件（>10MB）上传后卡住？必须限制内存和超时
不做限制时，io.ReadAll(file) 会把整个文件加载进内存，上传 100MB 文件直接 OOM。格式化本身（如 json.Indent）也会复制原始数据。
- 对 >5MB 的文件，改用流式处理：例如 JSON 格式化可用
json.Compact+json.Indent组合管道，边读边写到临时文件或io.Pipe - 设置
http.MaxBytesReader包裹r.Body，防止恶意超大 body 耗尽服务内存 - 上传 handler 内部设 context timeout（如
ctx, cancel := context.WithTimeout(r.Context(), 30*time.Second)），超时直接返回 413 - 临时文件写入建议用
os.CreateTemp("", "upload-*.tmp")，处理完立即os.Remove
格式化后如何安全返回给前端？别直接 WriteHeader(200) 就吐原始字节
返回内容类型错、缺失 Content-Disposition、没设缓存头，前端可能乱码或无法触发下载。
- 根据原始文件名和格式化结果动态设
w.Header().Set("Content-Type", mime)，JSON 用application/json; charset=utf-8，CSV 用text/csv; charset=utf-8 - 强制下载用
w.Header().Set("Content-Disposition", fmt.Sprintf(`attachment; filename="%s"`, url.PathEscape(newName))) - 若返回 HTML 预览页，确保
<meta charset="utf-8">存在，且响应体 UTF-8 编码无 BOM - 敏感内容（如含 token 的日志文件）格式化后要清空原始内存缓冲：
bytes.ReplaceAll(data, []byte("secret"), []byte("***"))后再data = append(data[:0], data...)
真正麻烦的是混合格式：比如一个 .log 文件里夹着 JSON 片段。这种得按行扫描+状态机识别，没法靠单一库解决——得提前跟业务方确认边界规则，而不是硬上通用方案。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
