-
stage函数必须显式close(out)而非defer，因defer在函数返回时才执行，若提前panic或context取消，上游可能仍在发送导致“sendonclosedchannel”；正确做法是所有退出路径统一关闭out且关闭前停止写入。
-
Go程序连不上MySQL，90%是MySQL未启动、端口未开放或用户权限不足；需检查bind-address、防火墙、创建专用用户并授权；使用database/sql+驱动，显式设连接池与超时参数，敏感信息用环境变量注入。
-
replace必须写在go.mod文件中，只对当前模块生效，不能通过命令行参数或环境变量覆盖；本地替换需确保路径、go.mod和module名三者完全一致。
-
NextSibling总是nil是因为HTML解析器不跳过文本/注释节点，应改用NextSiblingElement()或检查node.Type==html.ElementNode；解析href时需用base.ResolveReference(rel)规范化URL；乱码问题需通过charset.DetermineEncoding+NewReader自动检测编码；过滤链接应基于url.Parse后的Scheme和Fragment判断，而非字符串前缀。
-
zk.Connect不panic的关键是：传全地址列表、设5秒以上超时、连接后立即用State()检查是否为StateConnected，不能仅依赖err==nil。
-
生产环境应选用官方go-elasticsearch/v7客户端，需显式调用Do()、按字节而非条数切分bulk、解析聚合时先取键再断言类型。
-
swaginit需显式指定多目录路径并严格遵循注释格式：-g指定入口文件，-d列出internal/handler等子包；注释字段名、缩进、空格须精确匹配；泛型需手动@Schema声明；Nginx部署注意alias末尾斜杠。
-
Go函数参数永远传值，slice/map/chan因底层含指针字段而表现类似引用；array纯值类型，修改不影响原值；用指针参数需满足修改需求、大对象避免拷贝或接口要求指针接收者。
-
trace.Start()必须显式调用且配对trace.Stop()，否则trace.out为空或仅有头尾事件；常见原因包括未传*os.File、Stop未执行、程序过快退出、Start放置过晚。
-
Sync.Map不能用反射遍历，因其内部字段未导出且未实现迭代接口；必须通过Range()等公开API访问，注意nil检查、类型转换安全及性能陷阱。
-
Go语言中处理异常和错误的方式主要依赖于error返回和panic/recover机制。1.error返回用于常规错误处理，函数通过返回error值让调用者处理或忽略错误，适用于可预见的问题，如文件打开失败、网络请求超时等；2.panic用于触发运行时异常，程序沿着调用栈回溯，直到崩溃，适合处理不可预料的错误，如数组越界、空指针访问；3.recover只能在defer函数中使用，用来捕获panic，防止程序崩溃，常用于中间件统一拦截异常、测试代码模拟异常行为以及初始化阶段的关键错误处理；4.使用error
-
Go不需要传统迭代器模式，因其forrange已统一支持内建类型，且不支持用户自定义range行为；实践中常用channel或函数工厂替代Iterator接口。
-
Golang结合DevOps可通过自动化CI/CD流程提升交付效率与系统稳定性，典型流程包括代码提交、依赖检查、编译、测试、代码检查、镜像打包及部署；使用GitHubActions可实现从构建到测试的全流程自动化，配合Docker和Kubernetes完成持续交付；通过缓存优化、goreleaser多平台发布、代码覆盖率统计和Makefile统一命令可进一步提升效率，关键在于全流程自动化确保每次提交都随时可发布。
-
在Golang微服务开发中，多环境配置管理是保障服务在不同部署阶段（如开发、测试、预发布、生产）稳定运行的关键。配置不当容易导致环境混淆、密钥泄露或服务异常。实现清晰、安全、灵活的配置管理，能大幅提升开发效率和系统可靠性。使用结构化配置文件区分环境推荐使用JSON、YAML或TOML格式定义配置文件，并按环境命名，例如：config.dev.yaml、config.test.yaml、config.prod.yaml。启动服务时通过环境变量指定加载哪个配置。示例结构：typeCon
-
gofmt仅按Go官方约定统一重排代码，不支持任何个性化配置；日常只需记住gofmt-w写回文件，编辑器应优先使用gopls或goimports，并确保项目含go.mod。
