Go语言中实现文件下载可通过net/http和os包完成。1. 使用http.ServeFile创建下载接口，设置Content-Disposition响应头触发浏览器下载；2. 通过http.Get获取远程文件响应体，结合os.Create与io.Copy保存到本地；3. 建议添加超时控制、状态码检查、流式读写和User-Agent设置，确保稳定性和兼容性。
在Go语言中实现文件下载功能非常简单，主要依赖标准库中的 net/http 和 os 包。你可以通过创建一个HTTP处理器（Handler），将指定文件返回给客户端，或者从远程URL下载文件并保存到本地。下面分别介绍两种常见场景：提供文件下载接口和主动下载远程文件。
1. 提供文件下载接口（服务端）
如果你想让客户端可以通过访问某个URL来下载服务器上的文件，可以使用 http.ServeFile 方法，它会自动设置必要的响应头（如 Content-Disposition），触发浏览器下载。
示例代码：
package main
import (
"net/http"
)
func downloadHandler(w http.ResponseWriter, r *http.Request) {
// 指定要下载的文件路径
filePath := "./uploads/example.pdf"
// 设置响应头，提示浏览器下载文件
w.Header().Set("Content-Disposition", "attachment; filename=example.pdf")
w.Header().Set("Content-Type", "application/pdf")
// 使用 ServeFile 发送文件
http.ServeFile(w, r, filePath)
}
func main() {
http.HandleFunc("/download", downloadHandler)
http.ListenAndServe(":8080", nil)
}
访问 http://localhost:8080/download 即可触发文件下载。注意确保文件路径存在且有读取权限。
2. 从远程URL下载文件到本地
如果需要从互联网上下载文件并保存到本地磁盘，可以使用 http.Get 获取响应体，再用 os.Create 写入文件。
立即学习“go语言免费学习笔记（深入）”；
示例代码：
package main
import (
"io"
"net/http"
"os"
)
func downloadFileFromURL(url, filepath string) error {
// 发起GET请求
resp, err := http.Get(url)
if err != nil {
return err
}
defer resp.Body.Close()
// 创建本地文件
out, err := os.Create(filepath)
if err != nil {
return err
}
defer out.Close()
// 将响应体写入文件
_, err = io.Copy(out, resp.Body)
return err
}
func main() {
url := "https://example.com/sample.pdf"
path := "./sample.pdf"
err := downloadFileFromURL(url, path)
if err != nil {
panic(err)
}
println("文件下载完成:", path)
}
这个方法适合用于爬虫、资源抓取或定时同步远程文件等场景。记得处理网络错误和超时情况，生产环境中建议使用带超时的 http.Client。
3. 改进建议与注意事项
- 添加请求超时控制，避免长时间挂起
- 检查响应状态码（如 resp.StatusCode == 200）
- 对大文件使用分块读写（io.Copy 已经是流式处理，内存友好）
- 设置合理的User-Agent，避免被目标服务器拒绝
- 下载前校验本地路径是否存在，避免写入失败
