-
根本原因是未正确接管stdin/stdout/stderr的流式转发：需两个goroutine分别双向桥接WebSocket与session的IO，且不能用io.Copy阻塞等待EOF。
-
gomodinit路径须与最终导入路径一致，推荐直接使用GitHub地址如github.com/username/myapp；cmd/存放main包，internal/存放私有代码且不可被外部import；单模块项目无需go.work；Makefile可统一构建流程，需声明.PHONY。
-
Go程序容器内CPU忽高忽低主因是GOMAXPROCS未对齐CPU配额：运行时读取宿主机逻辑CPU数而非容器实际限额，导致goroutine在受限核上争抢；需通过cgroups或DownwardAPI动态设置GOMAXPROCS。
-
Go函数冷启动延迟高因main/init中耗时初始化，应移至包级变量+sync.Once；handler须无状态幂等；内存宜设128MB–512MB；所有I/O必须传入context.Context。
-
Delve默认会将被调试Go程序的stdout和stderr直接输出到调试器控制台，无需额外配置即可实时查看。
-
GoWebAPI分页核心是解析URL的page和limit参数并内存切片：page默认1且≥1，limit默认10且上限100；起始索引为(page-1)*limit，结束索引取min(start+limit,数据长度)；返回含Data、Page、Limit、Total、TotalPages的PaginatedResponse。
-
zerolog不是“导入就能用”的日志库，必须在首条log调用前设置全局级别、时间格式、level字段名，并通过.With().Timestamp().Logger()注入时间戳和静态字段，否则日志缺关键字段、级别被静默丢弃、线上panic无声无息。
-
不能直接用==比较结构体，仅当所有字段均为可比较类型（如string、int、指针）时才允许；含slice、map、func的结构体编译报错；指针比较地址而非内容；深度比较推荐cmp.Equal。
-
Go项目初期选RBAC即可，结构清晰易实现；ABAC仅在需动态条件（如部门匹配）时引入。权限校验须前置中间件，缓存权限至context或Redis，权限字符串统一用resource:action格式。
-
Go编写高性能TCP网关的核心是控制连接生命周期、复用内存和绕过默认阻塞行为，需手动补全net.Conn缺失的缓冲、Nagle禁用、保活与限流机制，否则易因频繁系统调用和GC压力导致CPU满载而带宽未打满。
-
goenv可一键管理多Go版本，支持安装、全局/本地/临时切换及卸载；通过gitclone安装，配置PATH与init后生效，shim机制确保环境隔离且不侵入系统。
-
Go函数必须显式返回error才能参与错误传播；应始终在函数签名中包含error、用%w包装错误、errors.Is/As判断类型、早失败快返回、不忽略Close错误。
-
Go标准库log不支持日志级别，仅提供Print/Fatal/Panic等函数，无Info/Warn/Error分级；需用第三方库（如logrus、zap）或自行封装前缀式Logger。
-
gobuild-gcflags="-m"是判断逃逸最直接有效的手段，关键线索是“movedtoheap”和“escapestoheap”语句，加-m-m可看推理链，加-l禁用内联以避免干扰；必然逃逸的写法包括返回局部变量指针、存地址到map/slice/interface、大结构体传入interface{}、闭包捕获并返回；避免逃逸应值传递、不返回局部地址、预分配切片、小结构体用值语义；逃逸非bug，但热路径高频逃逸会增加GC压力，需结合gotoolpprof-alloc_space定
-
Go标准库无终端文件选择器因其设计哲学强调“小而专”，仅提供底层I/O、路径处理等基础能力，不封装UI逻辑；需自行组合实现目录读取、交互渲染与键盘响应。
