Beego 文件上传下载需手动配置参数：不设 MaxMemory 和 MaxUploadSize 会导致大文件返回 413 错误；不设置 Content-Disposition 响应头，CSV/Excel 将在浏览器中直接渲染而非下载。
Beego 的文件上传和下载不是“开箱即用”的黑盒功能，而是依赖明确的参数控制、路径处理和响应头设置。不配 MaxMemory 和 MaxUploadSize，大文件直接 413；不设 Content-Disposition，CSV 或 Excel 就会直接在浏览器里渲染而不是下载。
上传前必须调优的两个全局参数
Beego 默认把小于 64MB 的文件全放内存，超过就写临时文件——但这个“64MB”是硬编码值（1），实际生产环境几乎总要改。
-
web.MaxMemory控制内存缓冲上限，建议设为1（16MB）或更低，避免单请求吃光服务内存 -
web.MaxUploadSize控制整个请求所有文件总大小，必须 >MaxMemory，否则GetFile永远拿不到文件句柄 - 两者都应在
main.go初始化阶段设置，晚于路由注册就无效 - 如果用配置文件方式（
conf/app.conf），写成maxmemory = 1<<24和maxuploadsize = 1<<26，注意单位是字节，不是 MB
GetFile 和 SaveToFile 的典型误用场景
GetFile("file") 的参数名必须和 HTML 表单中 <input type="file" name="file"> 的 name 属性完全一致，大小写敏感，且不支持点号或中划线——比如 "user.avatar" 会失败。
- 调用
GetFile后必须立刻检查 error，nil才代表有文件上传；否则后续file.Close()会 panic -
SaveToFile第二个参数是**完整目标路径**，不是目录。例如"./uploads/" + header.Filename是错的，应写成"./uploads/" + header.Filename并确保./uploads/目录已存在且进程有写权限 - 不要在
SaveToFile前对header.Filename做简单拼接，它可能含../或空字节，需先用path.Base()清洗 - 若需多文件上传，得循环调用
GetFile，每次传不同name，Beego 不提供类似GetFiles("files[]")的批量接口
触发浏览器下载的三种可靠方式
单纯返回文件路径（如 /staticfiles/report.pdf）不可靠：浏览器会按 MIME 类型决定是渲染还是下载。真正可控的方式只有三种。
- 用
SetStaticPath("/staticfiles", "./staticfiles")暴露目录后，在 HTML 中写<a href="/staticfiles/file.zip" download>，但仅对同源有效，且无法做权限校验 - 用控制器读取文件后手动写响应：
data, _ := os.ReadFile("./exports/data.csv")→this.Ctx.ResponseWriter.Write(data)，但大文件易 OOM - 最稳妥的是流式传输 + 正确响应头：先设
this.Ctx.Output.Header("Content-Type", "application/octet-stream")和this.Ctx.Output.Header("Content-Disposition", "attachment; filename=\"report.xlsx\"")，再用io.Copy(this.Ctx.ResponseWriter, file)，避免整块加载
CSV/Excel 导出容易忽略的字符集细节
中文 CSV 下载后 Excel 打开乱码，90% 是因为没加 BOM 或没声明 UTF-8。
- 必须在
Content-Type后缀加; charset=utf-8，例如"text/csv; charset=utf-8" - 对纯文本导出，写入内容前先输出 BOM：
this.Ctx.ResponseWriter.Write([]byte("\xef\xbb\xbf"))，否则 Windows Excel 默认用 ANSI - 用
csv.Writer时，writer.Flush()必须在 handler 函数 return 前调用，否则最后一行可能丢失 - 不要用
this.Ctx.WriteString返回 CSV 内容，它会自动加Content-Type: text/plain，覆盖你手动设的头
上传路径清洗、下载头顺序、BOM 插入时机——这些不是“可选优化”，而是决定功能是否可用的临界点。Beego 的文件处理逻辑清晰，但每一步都要求显式控制，漏掉任意一环，表现就是 413、空白页、乱码或浏览器内打开。
