-
Goerrors包仅支持基础错误创建，错误链、堆栈和上下文需用fmt.Errorf配合%w包装；errors.New适用于静态无参错误（如包级常量），fmt.Errorf用于格式化、变量插入或错误包装；errors.Is和errors.As仅对%w包装的错误有效，手动errors.Unwrap极少使用，因Is/As已自动递归处理错误链。
-
Go项目需先gitinit再gomodinit，module路径必须与Git远程URL完全一致（含协议、大小写），go.sum必须提交，vendor/通常不提交，版本号用vMAJOR.MINOR.PATCH格式Gittag管理。
-
Go无构造函数，推荐用零值语义、结构体字面量和NewXXX工厂函数初始化；嵌入可复用字段但不触发初始化，默认值应统一收敛至工厂函数。
-
Go微服务中配置mTLS需手动设置tls.Config：服务端用RequireAndVerifyClientCert+ClientCAs，私钥权限0600；gRPC需在Interceptor中解析TLSInfo获取身份；灰度迁移宜双端口或反代透传；curl报错多因未指定CA证书。
-
golang.org/x/oauth2需自行补全token刷新失败处理、并发刷新冲突、Expiry校验、IDToken签名及声明验证等安全机制，否则易致越权、伪造、凭据泄露等风险。
-
应优先使用filepath.WalkDir（Go1.16+）替代filepath.Walk，通过fs.WalkDirFunc处理err实现跳过权限错误、控制符号链接遍历，并避免在回调中执行耗时I/O操作。
-
Go1.13+默认启用GOPROXY，但国内需手动设为goproxy.cn或阿里云镜像并保留direct兜底；私有模块须同步配置GOPRIVATE和GONOSUMDB；临时禁用代理可用GOPROXY=direct前缀；排查下载慢需检查.netrc、gitconfig及网络劫持。
-
Go包文档格式是工具链契约：包注释须顶格写在package前且无空行，首句以包名开头并带句号；导出标识符注释须紧贴声明上方无空行；仅支持//行注释，禁用空行、制表符及Markdown。
-
Go1.13+应用fmt.Errorf配合%w动词嵌套错误以支持errors.Is/As查找，避免用%s拼接导致错误链断裂；需自定义错误类型并实现Unwrap()方法携带结构化字段，且%+v可递归打印完整错误链。
-
要显著提升Go语言网络应用性能，需从两方面入手：一是操作系统层面优化TCP协议栈参数，二是应用层实施连接池策略。1.调整TCP_NODELAY禁用Nagle算法以降低延迟；2.启用SO_REUSEADDR避免端口占用问题；3.合理设置SO_RCVBUF和SO_SNDBUF提升吞吐量；4.在HTTP客户端或自定义协议中使用连接池复用连接，减少资源开销；5.结合pprof工具进行基准测试与瓶颈分析，针对性调优并迭代验证效果。
-
使用高效结构体标签、sync.Pool复用对象、替换为json-iterator或easyjson库、减少不必要的编解码可显著提升Golang服务性能，推荐结合场景选择优化方案。
-
Go二进制默认静态链接、零外部依赖，但需警惕隐性环境依赖：cgo启用、外部命令调用、硬编码系统路径、TLS证书查找、DNS解析及嵌入资源管理。
-
sync.Locker接口本身不能直接new或实例化它只是个接口定义，只有Lock()和Unlock()两个方法。你没法写varlsync.Locker=new(sync.Locker)——Go不允许对接口做new。真正用的时候，得靠它的实现类型，比如sync.Mutex或sync.RWMutex。常见错误是试图把sync.Locker当成具体锁来传参或初始化，结果编译报错：cannotusesync.Locker(typeinterface)asty
-
跨包引用需确保import路径匹配go.mod中定义的模块路径，如modulegithub.com/yourname/project，则必须用github.com/yourname/project/pkg/utils；internal目录用于限制包可见性，仅同模块路径前缀的包可导入；循环引用应通过抽离公共包或接口解耦；升级依赖后需核对go.sum与vendor一致性以防运行时panic。
-
优化Web服务器性能需系统性调优：先从Nginx配置入手，启用Gzip压缩、合理缓存、调整Worker进程数及连接复用；再提升后端能力，选择合适运行模式、减少I/O等待、控制超时；接着进行系统级调优，增大文件描述符限制、优化网络参数、监控内存使用；最后加速静态资源交付，合并压缩前端资源、使用CDN、开启HTTP/2。持续通过压力测试与日志分析定位瓶颈，逐步优化。
