本文详解 panic: runtime error: invalid memory address or nil pointer dereference 在使用 bufio.Scanner 时的根本原因——commands.Scanner 未初始化即被调用，并提供完整的初始化时机修复方案与健壮性增强实践。
本文详解 `panic: runtime error: invalid memory address or nil pointer dereference` 在使用 `bufio.scanner` 时的根本原因——`commands.scanner` 未初始化即被调用，并提供完整的初始化时机修复方案与健壮性增强实践。
该 panic 的核心在于：commands.Scanner 是一个未初始化的 nil 指针，却在 main() 函数中直接调用了 commands.Scanner.Scan()。Go 中对 nil 指针调用方法会触发运行时 panic，错误栈明确指向 bufio.(*Scanner).Scan(0x0, ...)，其中 0x0 即表示 nil 地址。
问题根源在于 初始化时机与条件逻辑错位：
- init() 函数中通过 flag.String("filename", "", ...) 定义了命令行参数，但 flag.Parse() 后仅当 *sourceFlag != "" 时才调用 source.Input(...)；
- 若未传入 -filename 参数（例如直接运行 go run main.go），source.Input("") 不会被执行，导致 commands.Scanner 始终为 nil；
- 而 main() 函数第一行就执行 for commands.Scanner.Scan() {...}，此时访问 nil 指针，立即 panic。
✅ 正确做法是：无论是否指定文件，都必须确保 commands.Scanner 和 commands.Writer 被初始化。应移除 init() 中的冗余条件判断，统一调用 source.Input()，并在 source.Input() 内部处理空字符串逻辑：
// player/source/source.go
func Input(source string) {
if source != "" {
readFile, err := os.Open(source) // 注意：os.OpenFile + os.ModeExclusive 不适用于只读打开，应改用 os.Open
if err != nil {
log.Fatal("failed to open input file:", err)
}
commands.Scanner = bufio.NewScanner(readFile)
writeFile, err := os.Create(source + "_output.txt")
if err != nil {
log.Fatal("failed to create output file:", err)
}
commands.Writer = bufio.NewWriter(writeFile)
} else {
commands.Scanner = bufio.NewScanner(os.Stdin)
commands.Writer = bufio.NewWriter(os.Stdout)
}
}同时修正 init() 函数（移除条件分支）：
立即学习“go语言免费学习笔记（深入）”；
// main/init.go
func init() {
sourceFlag := flag.String("filename", "", "input source file path (optional)")
flag.Parse()
source.Input(*sourceFlag) // 总是调用，由 source.Input 内部决定初始化方式
}⚠️ 额外关键注意事项：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
os.OpenFile(..., os.ModeExclusive) 用于创建独占文件，不适用于只读打开 —— 应改为 os.Open(source)；
-
commands 包需导出 Scanner 和 Writer 字段（首字母大写），例如：
// player/command/command.go package command import "bufio" var ( Scanner *bufio.Scanner Writer *bufio.Writer Pwd string Commands = map[string]bool{"ls": true, "cd": true /*...*/} ) main() 中 fmt.Printf("$ %s:", commands.Pwd) 在首次循环前可能因 Pwd 未初始化而输出空字符串，建议在 source.Input() 后显式设置初始值（如 commands.Pwd = "/"）；
所有 bufio.Writer 使用后应调用 Writer.Flush()，否则缓冲内容可能丢失（尤其在文件输出场景）。
总结：Go 中全局变量的初始化必须满足「确定性」和「无条件性」。依赖命令行参数决定是否初始化关键 I/O 对象，本质是将初始化责任错误地推给了调用方。正确模式是——init() 或 main() 开头完成所有必要初始化，让业务逻辑（如 main() 中的 Scan() 循环）始终运行在已就绪的状态之上。
