新手写第一个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) }——这会让程序崩溃并打印冗长堆栈，不利于调试。
立即学习“go语言免费学习笔记（深入）”；
- 换成
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 run 就是最新结果——盯住这个反馈闭环，比追求功能完整重要得多。
