直接用 io.copy 将 resp.body 写入 *os.file 是最安全高效的方式，因为绕过解码可避免失真、保全原始编码与元数据，并节省内存与 cpu；而 image.decode → image.encode 不必要且易出错，仅在需图像处理时才适用。
直接用 io.copy 把 resp.body 写进 *os.file，别解码、别读全量到内存、别漏关资源——这是最安全高效的路径。
为什么不能直接用 image.Decode 再写文件？
很多新手看到“下载图片”，第一反应是走 image.Decode → image.Encode 流程。这完全没必要，还容易出错：
• image.Decode 会把原始二进制（比如 JPEG header + DCT 数据）解析成 image.Image 结构，丢失原始编码信息；
• 再用 jpeg.Encode 写出的文件，大小、元数据、色度抽样都可能和源文件不一致；
• 更关键的是：如果只是缓存或代理分发，你根本不需要触碰像素数据——绕过解码，直传字节流，既快又保真。
• 错误示例中常见 ioutil.WriteFile(..., m, ...)，编译就报错：不能把 image.Image 当 []byte 传。
http.Get 返回 403 或空响应体怎么办？
不是代码有 bug，是服务端把你当爬虫拦截了。
• 默认 http.Get 不带任何 User-Agent，Nginx、CDN、GitHub raw 都会直接返回 403；
• GitHub raw 还要求显式声明 Accept: application/octet-stream，否则返回 HTML 页面而不是二进制流；
• 实操必须：
- 用
http.NewRequest构造请求，手动设req.Header.Set("User-Agent", "Mozilla/5.0") - 加
req.Header.Set("Accept", "application/octet-stream")（尤其对 raw.githubusercontent.com） - 检查
resp.StatusCode，别只看 err 是否为 nil；404/500 的 body 可能非空，但你不该保存
怎么安全处理用户传入的 URL 和文件名？
URL 里可能藏 ../../etc/passwd，文件名可能含 : 或 <p>URL 里可能藏 <code>../../etc/passwd，文件名可能含 : 或 \0，Go 标准库不帮你过滤。
• 别用 filepath.Join(dir, filename) 直接拼——filename 是攻击入口；
• 正确做法：
• 别用
filepath.Join(dir, filename) 直接拼——filename 是攻击入口；• 正确做法：
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 从 URL 解析出原始文件名后，用
strings.TrimSuffix(filepath.Base(urlPath), "/")截取，再用strings.Map或正则删非法字符（如 Windows 的:"/\|?*） - 构造完整路径后，用
filepath.Abs转绝对路径，再用strings.HasPrefix(absPath, allowedRoot)确保没逃出目标目录（比如只允许写入/tmp/downloads） - 调用
os.MkdirAll(filepath.Dir(destPath), 0755)确保父目录存在
大文件下载卡住、连接堆积、进度看不到？
核心问题是默认 http.DefaultClient 没超时、没上下文、没监控。
• 必须用自定义 client：
-
Timeout: 30 * time.Second防止卡死 - 配
Transport.IdleConnTimeout和MaxIdleConnsPerHost控制连接复用 - 传
context.WithTimeout给client.Do(req.WithContext(ctx))，支持主动取消
• 要进度反馈？
io.Copy 不暴露读取量，得包一层：type ProgressReader struct { Reader io.Reader; total, written int64 }，在 Read 方法里累加并回调；• 断点续传不是默认行为：先
HEAD 检查 Accept-Ranges: bytes，再 GET 时加 Range: bytes=1024-，且必须用 os.O_APPEND 打开已存在文件。真正难的从来不是“怎么写几行代码”，而是判断哪个响应该信、哪个路径该拦、哪个连接该杀、哪个字节该丢——这些边界条件，不跑真实流量根本压不出来。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
