新手写第一个Go项目应从1小时内可跑通的命令行小工具开始，如用os.ReadDir和os.WriteFile收集.txt文件名，配合flag读取参数、log.Fatal处理错误，聚焦语言本身而非框架。

新手写第一个 Go 项目，别从“博客系统”或“待办清单”开始——它们看似简单，实则过早引入数据库、模板渲染、HTTP 路由等干扰项，容易卡在环境配置或框架选择上，反而掩盖了 Go 本身的语言特性。真正适合起步的项目，应该能让你在 1 小时内跑通完整流程：写代码 → 编译 → 运行 → 看到输出 → 修改 → 再运行。

用 main.go 直接读写文件，不碰网络和依赖

绕开 go mod init 和第三方包，直接新建一个 main.go，用标准库完成一件事：比如把当前目录下所有 .txt 文件名收集起来，写进 list.txt。这样你只用到 os.ReadDir、os.WriteFile 和基础循环。

• 避免一上来就 go get github.com/xxx，新手常因代理、Go 版本或 GOPROXY 导致失败，挫败感强
• os.ReadDir 比 ioutil.ReadDir（已弃用）更安全，返回 fs.DirEntry，不强制读取全部文件信息
• 写入时用 os.WriteFile("list.txt", []byte(content), 0644)，权限参数别写成 0755——文本文件不需要执行位

用 flag 包替代硬编码路径，理解命令行交互

把文件扩展名和输出路径从代码里抽出来，改成命令行参数。这比学 Web 框架路由更贴近 Go 的设计哲学：小工具、可组合、显式传参。

• 加两行：ext := flag.String("ext", "txt", "file extension to search") 和 flag.Parse()
• 运行时用 go run main.go -ext md，立刻看到行为变化，比改代码再编译反馈更快
• 注意 flag 必须在 main() 开头调用，放在 if 或循环里会 panic："flag provided but not defined"

用 log.Fatal 替代 panic 处理错误，养成显式错误路径习惯

Go 不允许忽略错误，但新手常写 _, err := os.ReadDir("."); if err != nil { panic(err) }——这会让程序崩溃并打印冗长堆栈，不利于调试。

• 换成 if err != nil { log.Fatal("read dir failed: ", err) }，输出干净，且自动退出（等价于 os.Exit(1)）
• log.Fatal 是标准库推荐做法，比自己写 fmt.Println + os.Exit 更一致
• 不要用 log.Printf 后继续执行——很多新手在这里埋下逻辑错误：错误发生后还试图用无效变量

真正卡住新手的，往往不是语法，而是对“构建即部署”的不适应：Go 编译出单个二进制，没有 node_modules 或 venv；也没有隐藏的初始化逻辑。把 main.go 改几行，go r