必须检查os.Open返回的error，因Go无异常机制，忽略会导致panic或逻辑错误；需用if err != nil判断，且用errors.Is(err, fs.ErrNotExist)区分错误类型。
判断 os.Open 是否失败必须检查返回的 error
Go 不支持异常机制，所有 IO 错误都通过返回的 error 值显式传递。忽略它等于默认文件一定存在、可读、权限正确——这在生产环境几乎从不成立。
常见错误现象：程序 panic 或静默跳过后续逻辑，因为 file 是 nil 但没被发现。
- 永远用
if err != nil检查os.Open、os.Create、ioutil.ReadFile（已弃用）等函数的error返回值 - 不要只检查
file == nil：即使打开失败，file可能非nil（比如部分初始化成功），但调用其方法会 panic - 使用
errors.Is(err, fs.ErrNotExist)区分「文件不存在」和「权限不足」等具体原因，便于差异化处理
file, err := os.Open("config.json")
if err != nil {
if errors.Is(err, fs.ErrNotExist) {
log.Fatal("配置文件丢失，请检查路径")
}
log.Fatal("打开文件失败：", err)
}
defer file.Close()
io.ReadFull 和 io.ReadAtLeast 的错误语义容易误判
这两个函数不是简单包装 Read，它们对「读取字节数不足」有明确的错误约定，直接和 io.EOF 混淆会导致逻辑错误。
-
io.ReadFull要求**必须读满**指定字节数，少一个字节就返回io.ErrUnexpectedEOF，而不是io.EOF -
io.ReadAtLeast要求**至少读到**指定字节数，若底层返回io.EOF且已读够，则不报错；若不够，才返回io.ErrShortBuffer - 别用
errors.Is(err, io.EOF)判断ReadFull是否失败——它根本不会返回io.EOF
buf := make([]byte, 1024)
n, err := io.ReadFull(file, buf)
if err != nil {
if errors.Is(err, io.ErrUnexpectedEOF) {
// 文件比预期短，可能是损坏或截断
log.Printf("读取不完整，仅读到 %d 字节", n)
} else {
log.Println("读取失败：", err)
}
}
关闭文件时的错误常被忽视但可能关键
file.Close() 可能返回错误，尤其在写入场景下：缓冲区 flush 失败、磁盘满、NFS 连接中断等，都会在此刻暴露。忽略它等于放弃最后的数据一致性校验机会。
wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support
下载
基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。
立即学习“go语言免费学习笔记（深入）”；
- 写入后
Close()报错，意味着数据可能未落盘，不能认为写入成功 - 不要把
defer file.Close()当作“一定会执行且无害”的保险——它仍可能失败，且defer不捕获错误 - 写操作推荐模式：
Write→Close→ 检查两个错误；或改用os.WriteFile（原子写，自动处理 close）
f, _ := os.Create("output.txt")
_, err := f.Write([]byte("hello"))
if err != nil {
log.Fatal("写入失败：", err)
}
err = f.Close() // 必须检查
if err != nil {
log.Fatal("关闭失败（数据可能未保存）：", err)
}
跨平台路径和权限错误的兼容性陷阱
Windows 和 Unix-like 系统对路径分隔符、权限掩码、特殊文件（如 /dev/null）的处理差异极大，硬编码路径或忽略 os.PathSeparator 会导致运行时错误。
- 用
filepath.Join("dir", "sub", "file.txt")替代字符串拼接，避免"dir/sub/file.txt"在 Windows 下失效 -
os.MkdirAll(path, 0755)中的权限掩码在 Windows 上被忽略，但错误地设为0644可能导致目录不可遍历 - 检查
os.IsPermission(err)和os.IsNotExist(err)，而非依赖错误字符串匹配
复杂点在于：有些错误（如 symlink 循环、too many open files）无法靠重试解决，需提前限流或换用更健壮的库（如 golang.org/x/exp/io/fs 的封装）。真正难的不是写 if err != nil，而是读懂 err 背后系统层的真实约束。
