本文介绍如何使用 Go 标准库的 net/http 和 io 包安全、高效地下载远程文件（如图片），并持久化保存至本地磁盘，适用于网页资源预加载等场景。
本文介绍如何使用 go 标准库的 `net/http` 和 `io` 包安全、高效地下载远程文件（如图片），并持久化保存至本地磁盘，适用于网页资源预加载等场景。
在 Go 中下载并保存文件是一个常见需求，例如从 Instagram 等外部服务拉取图片，缓存至项目 public/ 目录供 Web 页面直接引用。核心思路是：发起 HTTP GET 请求获取响应流，然后将响应体（resp.Body）逐字节复制到本地文件句柄中。以下是一个健壮、可复用的实现：
import (
"io"
"net/http"
"os"
)
// downloadFile 下载指定 URL 的内容并保存到本地 filepath
// 支持任意二进制文件（如 JPG、PNG、PDF 等）
func downloadFile(filepath, url string) error {
// 创建目标文件（含路径自动创建支持需额外处理，见下方说明）
out, err := os.Create(filepath)
if err != nil {
return err
}
defer out.Close()
// 发起 HTTP GET 请求
resp, err := http.Get(url)
if err != nil {
return err
}
defer resp.Body.Close()
// 检查 HTTP 状态码是否为成功状态（2xx）
if resp.StatusCode < 200 || resp.StatusCode >= 300 {
return &http.ResponseError{
Response: resp,
Err: http.ErrUseLastResponse,
}
}
// 将响应体流式写入文件，避免内存爆满（适合大文件）
_, err = io.Copy(out, resp.Body)
return err
}✅ 关键改进点（相比原始代码）：
- 增加了 HTTP 状态码校验，防止静默保存 404/500 等错误响应；
- 移除了冗余的 err != nil 判断链，提升可读性；
- 显式返回标准错误类型，便于上层统一处理。
⚠️ 生产环境注意事项：
- 目录创建：os.Create() 不会自动创建父目录。若 filepath 含深层路径（如 "public/images/insta/abc.jpg"），请先调用 os.MkdirAll(filepath.Dir(), 0755)；
-
超时控制：建议使用带超时的 http.Client 替代 http.Get()，避免请求无限挂起：
client := &http.Client{Timeout: 30 * time.Second} resp, err := client.Get(url) -
用户代理（User-Agent）：部分网站（如 Instagram）会拦截无 UA 的请求，可设置：
req, _ := http.NewRequest("GET", url, nil) req.Header.Set("User-Agent", "Mozilla/5.0 (Go App)") resp, err := client.Do(req) - 并发与限速：批量下载时应添加 goroutine 限制和速率控制，避免触发反爬机制。
该方案轻量、零依赖、符合 Go 的“简单即美”哲学，已广泛用于静态资源预热、CDN 回源缓存等实际场景。
