应优先使用 os.readfile 读取文件，它自动处理关闭、错误和缓冲，比 os.open + io.readall 更安全简洁；大文件才需流式读取；注意路径、编码器选择及错误处理。
读取文件时直接用 os.ReadFile，别手动开文件句柄
很多人习惯先 os.Open 再 io.ReadAll，其实大可不必。Go 1.16+ 的 os.ReadFile 内部已做优化，自动处理关闭、错误和缓冲，代码更短也更安全。手动管理 file.Close() 容易漏掉，尤其在多个 return 路径下。
- 用
os.ReadFile("path/to/file")直接拿到[]byte - 如果文件可能很大（比如 >10MB），才考虑流式读取 + 分块 base64 编码，否则内存压力小，直接全读更简单
- 注意路径是相对运行目录的，不是源码目录；调试时建议加
fmt.Printf("reading: %s\n", absPath)确认路径是否正确
Base64 编码要用 encoding/base64.StdEncoding.EncodeToString
base64 包提供两种常用编码器：StdEncoding（标准 RFC 4648）和 URLEncoding（无 +//，用 -/_ 替代）。传给 HTTP API 或存 JSON 一般选 StdEncoding；URL 查询参数或文件名中嵌入则用 URLEncoding。
- 别写
base64.StdEncoding.Encode([]byte{}, data)—— 这个函数返回的是[]byte，还得再转string；直接用EncodeToString(data)更直白 - 如果后续要解码回文件，确保编码器和解码器一致，混用
StdEncoding和URLEncoding会报illegal base64 data - 编码本身不校验内容，空文件或二进制乱码也能成功编码，所以解码前建议先检查长度是否为 4 的倍数（非必须，但能早发现问题）
常见错误：忘记处理 os.ReadFile 的 error，导致 panic 或静默失败
Go 的 error 不是异常，不显式判断就继续往下走，常导致 nil 数据传给 EncodeToString，触发 panic：panic: runtime error: slice of nil。
- 必须写
if err != nil分支，哪怕只是log.Fatal(err)或返回错误 - 不要写
_, _ := os.ReadFile(...)忽略 error —— 这会让程序在找不到文件时继续执行，后面出错难以定位 - Windows 下路径含中文或空格时，
os.ReadFile可能返回no such file or directory，但错误信息里不带具体路径，建议提前用filepath.Abs打印绝对路径辅助排查
完整可跑示例（含错误处理和路径确认）
package main
import (
"encoding/base64"
"fmt"
"log"
"os"
"path/filepath"
)
func main() {
filePath := "example.pdf"
absPath, _ := filepath.Abs(filePath)
fmt.Printf("Attempting to read: %s\n", absPath)
data, err := os.ReadFile(filePath)
if err != nil {
log.Fatalf("failed to read file: %v", err)
}
encoded := base64.StdEncoding.EncodeToString(data)
fmt.Println("Base64 length:", len(encoded))
fmt.Println("First 64 chars:", encoded[:min(64, len(encoded))])
}
func min(a, b int) int {
if a
<p>这个例子没用任何第三方库，只依赖标准库，复制就能跑。注意 <code>min</code> 是为了防止切片越界，Go 没内置 <code>min(int, int)</code>，小工具函数自己补一个就行。</p>
<p>真正容易被忽略的是：Base64 编码后体积膨胀约 33%，如果后续要存数据库或发网络请求，得提前评估长度限制（比如 MySQL TEXT 最大 65535 字节，编码前原始文件别超 49KB）。</p>golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
