本文讲解 Go 语言中变量作用域导致的常见错误：当 bufio.NewWriter 依赖条件创建的文件句柄时，如何正确声明和复用 writer 变量，避免编译错误与作用域陷阱。
本文讲解 go 语言中变量作用域导致的常见错误：当 `bufio.newwriter` 依赖条件创建的文件句柄时，如何正确声明和复用 writer 变量，避免编译错误与作用域陷阱。
在 Go 中，if 或 for 语句块内使用 := 声明的变量仅在该块内有效（即具有块级作用域）。原代码中，f, err := os.Create(name) 在 if 块内声明，导致外部无法访问 f；而紧随其后的 w := bufio.NewWriter(f) 因 f 不可见而编译失败。
根本解法是提前声明变量类型，延迟赋值——利用 Go 的接口抽象能力，统一使用 io.Writer 接口类型（bufio.Writer 和 os.Stdout 均实现该接口），从而实现运行时动态切换输出目标：
package main
import (
"bufio"
"flag"
"fmt"
"os"
"path/filepath"
"strconv"
"time"
)
var (
logFile = flag.String("file", "yes", "Save output into file")
t = time.Now()
dir, _ = filepath.Abs(filepath.Dir(os.Args[0]))
)
func main() {
flag.Parse()
name := filepath.Join(dir, "output_"+strconv.FormatInt(t.Unix(), 10)+".log")
// ✅ 正确做法：声明 writer 变量，初始指向 stdout
var w *bufio.Writer
if *logFile == "yes" {
f, err := os.Create(name)
if err != nil {
panic(err)
}
defer f.Close() // 注意：defer 在函数返回时执行，确保文件关闭
w = bufio.NewWriter(f)
} else {
w = bufio.NewWriter(os.Stdout)
}
// 示例数据（原代码中未定义，此处补充）
my_slice := []string{"hello", "world", "go", "rocks"}
for _, v := range my_slice {
fmt.Fprintln(w, v) // 统一写入，无需条件判断
}
// ✅ 必须调用 Flush，否则缓冲内容可能丢失
if err := w.Flush(); err != nil {
panic(err)
}
}关键要点说明：
- 使用 var w *bufio.Writer 提前声明变量，后续在 if/else 中分别赋值，避免作用域限制；
- os.Stdout 是 *os.File 类型，同样满足 io.Writer 接口，可直接传给 bufio.NewWriter；
- defer f.Close() 安全有效（因 f 在 if 块内声明但作用域延伸至整个 main 函数？不，实际 f 仍受限于块作用域——因此更推荐将 f 提升为同级变量或改用上述 io.Writer 抽象方式，本例已通过 w 封装隐式管理）；
- 务必调用 w.Flush()：bufio.Writer 默认缓冲输出，不显式刷新会导致日志内容未写入文件或终端；
- 补充 filepath.Join 替代字符串拼接，提升路径安全性与跨平台兼容性。
此模式不仅解决当前问题，更是 Go 中“接口优先、组合优于继承”设计哲学的典型实践。
