很多人学完Go语法后信心满满,打开编辑器准备写个真实项目,结果卡在第一步就动不了。不是语法不会,而是不知道从哪里下手。这篇文章不聊虚的,直接把我带人做Go项目时遇到的真实卡点摊开说,每个卡点配一个具体场景和可操作的解决思路,你对照看看自己中了几个。
第一个坑:包结构照搬教程,放到自己项目里就乱套。教程里的项目通常只有main.go和几个零散文件,一旦你要做一个带数据库、带接口、带定时任务的完整服务,目录怎么分就成了大问题。常见的错误是把所有代码塞进main包,或者建了一堆internal目录但不知道什么该放进去。比较稳妥的做法是按职责分层:cmd放启动入口,internal放业务逻辑,pkg放可复用的工具,config放配置加载,api放路由和处理器定义。别一上来就追求大厂架构,先保证每个目录只有一件事,后面再拆分也不迟。
第二个坑:错误处理写成流水账。Go的if err != nil是特色,但新手容易写成每行一判断,代码又长又难读。真实项目里更推荐的做法是尽早返回,把正常路径保持在最外层,错误路径缩进处理。同时善用fmt.Errorf配合%w包装错误,让调用链能追溯原因,而不是把原始错误吞掉只打印一句“操作失败”。这个习惯不建立,后期排查线上问题会非常痛苦。
第三个坑:并发用得随意,goroutine泄漏不自知。看几个例子就敢在循环里go出去,结果请求量一上来内存暴涨。写并发代码前先问自己三个问题:这个任务真的需要异步吗、有没有退出机制、结果怎么收集。用context控制生命周期,用sync.WaitGroup等待任务结束,用带缓冲的channel限制并发数量,这三样是保底配置。别等到服务跑了一周才发现goroutine数量只增不减。
第四个坑:数据库操作全靠手写SQL拼接。Go的标准库很克制,没有内置ORM,新手要么全手写导致重复代码泛滥,要么随便找个库但不会用事务。建议先从database/sql加手写查询开始,把连接池参数、上下文超时、事务回滚这几件事搞明白,再去考虑轻量封装。至少要知道Rows必须Close,Prepare的语句要复用,否则连接池很快会被耗尽。
第五个坑:配置和密钥硬编码在代码里。本地跑得好好的,一换环境就报错,或者把数据库密码提交到了仓库。正确姿势是用环境变量加配置文件双层加载,敏感信息一律走环境变量,配置文件只放非敏感的默认值。启动时做一次校验,缺关键配置直接报错退出,别等到运行到一半才发现连不上。
第六个坑:不会写测试,改一行代码心里没底。Go的测试工具链很顺手,但新手往往觉得测试是额外负担。实际做法是先给核心函数写表驱动测试,覆盖正常值和边界值,再给接口层写几个httptest用例。不用追求覆盖率数字,先把最容易出错的那几个函数保护起来。有了测试,你重构时才有底气,否则每次改动都是赌博。
说完坑,再说一个被忽略的正面习惯:从第一天起就写清楚README和启动脚本。很多人的项目在自己机器上能跑,换个人就起不来,原因就是缺一句“先执行哪个命令、需要哪些环境变量”。花十分钟写清楚,比后期解释半小时管用。
最后给一个可执行的练习路径:找一个真实的小需求,比如做一个短链接服务或者一个定时抓取天气并推送的机器人。从路由设计、数据存储、错误处理到部署上线完整走一遍,遇到问题再回头补语法。语法是查得到的,工程习惯是练出来的。把上面六个坑逐个避开,你的第一个Go项目就能从“能跑”变成“敢给别人看”。