-
pprof服务没起来？检查net/http/pprof是否已注册Go程序默认不暴露pprof接口，必须手动注册。常见错误是只导入了net/http/pprof却没调用任何初始化逻辑，结果访问/debug/pprof/返回404。正确做法是确保HTTP路由中已挂载pprofhandler：若使用默认mux：只需import_"net/http/pprof"（下划线导入触发init），且程序启动了http.ListenAndServe若用自定义mux（如
-
Go标准库随Go安装包自带，无需单独安装；只需验证Go环境（goversion、goenvGOROOT/GOPATH）、编译运行含标准包的程序，并确保GOROOT指向正确的源码目录$GOROOT/src。
-
jwt-gov4+禁用none等不安全算法且Parse不校验签名，须用ParseWithClaims配合密钥回调和StandardClaims嵌入，并区分错误类型返回对应状态码。
-
推荐使用filepath.WalkDir而非filepath.Walk：性能更高（避免重复os.Stat）、控制更强（支持filepath.SkipDir）、更安全（可主动处理权限错误、软链接环路、递归深度）；匹配逻辑应解耦为可组合的Matcher函数，路径判断优先用strings.HasSuffix；结果需后排序，不依赖遍历顺序。
-
Go错误处理需在首次出错处用errors.WithStack加栈，后续用%w包装；HTTP请求注入traceID到error中；用slog.Any("error",err)统一日志格式；对高频panic如"contextcanceled"做白名单过滤和限流。
-
Go字符串底层是UTF-8编码的只读字节序列，len(s)返回字节数而非字符数；中文占3字节、emoji如“?”占4字节；遍历应使用range获取rune，避免用索引截取或手动拼接非法UTF-8。
-
strconv.Atoi返回error时需用iferr!=nil检查并处理，不可忽略；可类型断言*strconv.NumError获取详情，用errors.Is(err,strconv.ErrRange)等标准方式判断错误类型；推荐封装SafeAtoi函数提供默认值，或改用更灵活的strconv.ParseInt。
-
goroutine中的panic必须在内部用recover捕获，因为panic不跨协程传播，子协程panic后静默退出，主协程不受影响但可能导致数据丢失、资源泄漏、任务中断且无日志；recover仅在本协程defer中有效，需配合debug.Stack()结构化记录并及时退出，不可继续执行业务逻辑。
-
Go的error接口判断几乎零开销，真正性能瓶颈在于错误构造时的堆分配；应复用预定义错误变量、避免循环内fmt.Errorf、慎用panic替代错误返回。
-
HTTP状态码需精准语义化：400表请求解析失败（如JSON格式错），422表业务校验失败（如邮箱已存在）；避免冗余code字段，确保状态码与响应头一致；重定向仅用于浏览器跳转场景，RESTfulAPI禁用3xx。
-
为什么Kubernetes扩容后Pod会拿到重复IP？这不是Go程序写错了，而是底层CNI插件（比如calico、flannel）分配IP时没同步好状态，或者IPAM（IP地址管理）后端（如etcd）出现脑裂或写入失败。Go应用本身不参与集群IP分配，但如果你在代码里硬编码了"10.244.1.100"这类地址，或者依赖本地/etc/hosts做服务发现，扩容后旧IP被复用就会直接撞上。Pod删除后IP不一定立即释放，CNI可能延迟回收多个节点上
-
Go中nil指针访问panic的本质是底层内存访问违规，不可recover；必须在解引用前显式检查，如ifp!=nil再使用*p或p.Field。
-
使用唯一且可解析的导入路径，如github.com/username/projectname/packagename，确保全局唯一并支持goget拉取；通过go.mod定义模块根路径，所有子包基于此路径导入，避免相对或非标准路径；将内部包置于internal目录下限制外部访问；v2及以上版本在模块名末尾添加版本号以符合语义化版本规则；坚持远程路径导入、合理使用internal、遵守模块版本规范，提升项目可维护性与模块化程度。
-
Go模块私有包权限管理依赖GOPRIVATE与GIT_TERMINAL_PROMPT环境变量协同，配合Git凭据配置或SSH密钥，禁用代理并启用认证；路径匹配为前缀匹配，非递归通配。
-
根本原因是PATH未正确配置，导致系统找不到go命令；需根据操作系统将Go的bin目录加入PATH，并验证whichgo或wherego输出，再执行goversion确认。
