如何在 Go 中使用 io.ReadAll 替代 ioutil.ReadAll-Golang-PHP中文网

ioutil.readall 在 go 1.16 中被弃用，因其归属不合理，应归入 io 包；现统一使用 io.readall，需替换导入和调用，且仍须显式关闭 reader 并注意内存与上下文控制。

如何在 go 中使用 io.readall 替代 ioutil.readall

为什么 `ioutil.ReadAll` 被弃用了

ioutil.ReadAll 在 Go 1.16 中正式被标记为 deprecated，不是因为它不能用，而是因为它的归属不合理：它本该属于 io 包，却长期躲在 ioutil（一个纯工具包）里。Go 团队把通用 I/O 操作统一收归 io，所以 io.ReadAll 成了标准替代方案。继续用 ioutil.ReadAll 不会报错，但 go vet 会警告，且新项目应避免引入已弃用的包。

`io.ReadAll` 的基本用法和签名差异

两者签名几乎一样：func ReadAll(r io.Reader) ([]byte, error)，但来源包不同。迁移时只需改导入和函数调用，其他逻辑不变。

删掉 "io/ioutil" 导入，加上 "io"
把所有 ioutil.ReadAll(r) 替换为 io.ReadAll(r)
注意：ioutil 包里还有 ReadFile、WriteFile 等，它们被移到了 os 包，别混淆

示例：

使用Go语言搭建家庭相册系统-相关课件

下载

// 旧写法（不推荐）
import "io/ioutil"
data, err := ioutil.ReadAll(resp.Body)

// 新写法
import "io"
data, err := io.ReadAll(resp.Body)

常见误用：忘记关闭 `resp.Body` 或其他 `io.ReadCloser`

io.ReadAll 只负责读，不负责关。很多人只替换函数，却漏掉 defer resp.Body.Close()，导致 HTTP 连接泄漏或文件句柄耗尽。

HTTP 响应体必须显式关闭：defer resp.Body.Close() 要在 io.ReadAll 之前或之后（但不能省略）
对 os.File 同理：先 defer f.Close()，再 io.ReadAll(f)
如果读取后还要复用 reader（比如多次读），io.ReadAll 会消耗掉全部数据，后续再读会返回空 —— 它不是“peek”，而是“consume”

性能与边界情况：大文件、超长流、context 控制

io.ReadAll 没有内置超时或内存限制，它会一直读直到 EOF 或错误。这对不可信输入（如用户上传、第三方 API）很危险。

读取不受控的响应体可能 OOM：考虑用 io.LimitReader 包裹，例如 io.ReadAll(io.LimitReader(r, 10*1024*1024)) 限制 10MB
需要上下文取消？io.ReadAll 不接受 context.Context，得自己封装：用 http.NewRequestWithContext 控制请求，或用 io.CopyN + channel 分块读
若需流式处理大文件，别全读进内存 —— 直接用 io.Copy 或逐块 io.Read 更稳妥