Go 中使用 log.SetOutput() 配置文件日志时，若在函数内 defer f.Close() 会立即关闭文件句柄，导致后续日志无法写入；需将文件句柄生命周期与日志器绑定，延迟关闭时机。
go 中使用 `log.setoutput()` 配置文件日志时，若在函数内 `defer f.close()` 会立即关闭文件句柄，导致后续日志无法写入；需将文件句柄生命周期与日志器绑定，延迟关闭时机。
在 Go 应用中，将日志输出重定向到文件是常见需求，但一个典型陷阱是：日志文件被过早关闭，致使 log.Println() 等调用静默失败（无错误提示，但内容未落盘）。根本原因在于 defer f.Close() 的执行时机——它会在函数返回前立即触发，而此时 log.SetOutput(f) 仅完成了输出目标的设置，并未真正执行任何日志写入（日志调用发生在函数外部或后续代码中）。
✅ 正确做法：分离初始化与关闭逻辑
应将日志文件句柄（*os.File）提升为可被长期持有的状态（如包级变量），并在程序生命周期合适阶段（如 main 函数退出前）显式关闭：
package main
import (
"log"
"os"
"io"
)
var logFile io.Closer // 接口类型便于统一管理
func InitLogger() error {
f, err := os.OpenFile(
"C:/Project/GoLang/src/Logs/LogOutput/TestLog.log",
os.O_CREATE|os.O_APPEND|os.O_WRONLY,
0644, // 建议使用 0644 而非 0666，更安全
)
if err != nil {
return err
}
logFile = f
log.SetOutput(f)
log.SetFlags(log.LstdFlags | log.Lshortfile) // 推荐：添加时间戳和文件行号
return nil
}
func CloseLogger() error {
if logFile != nil {
return logFile.Close()
}
return nil
}然后在 main() 中按序调用：
func main() {
if err := InitLogger(); err != nil {
log.Fatalf("failed to initialize logger: %v", err)
}
defer CloseLogger() // 确保程序退出前关闭
log.Println("Application started")
log.Printf("Processing item #%d", 42)
// 其他业务逻辑...
}⚠️ 注意事项
-
避免
os.O_RDWR：日志写入只需写权限，使用os.O_WRONLY更语义清晰且减少潜在冲突； -
权限设置：Windows 下
0666可能被系统忽略，Linux/macOS 下建议0644（所有者读写、组/其他只读）； -
并发安全：标准
log包本身是 goroutine-safe 的，无需额外同步； -
不依赖
defer在初始化函数中关闭：这是本问题的核心误区，defer属于当前函数作用域，不可跨函数“延迟”到日志实际使用之后； -
替代方案考虑：对于复杂场景（如日志轮转、多级别输出），推荐使用成熟库如
zap或logrus，它们内置了资源生命周期管理和高性能写入。
通过合理管理文件句柄生命周期，即可确保所有 log.Print* 调用均能稳定、完整地写入目标日志文件。
