-
导入路径由模块根目录和相对目录路径共同决定，例如模块example.com/myapp下utils/helper.go的包通过import"example.com/myapp/utils"引入，目录名通常作为包名，项目根目录需包含go.mod文件以定义模块起点，子目录不单独设go.mod，且Go不支持相对路径导入，必须使用基于模块的绝对导入路径。
-
启动子进程需设SysProcAttr实现进程组隔离，加context超时控制，用Signal(SIGTERM)优雅停止并Wait回收，跨平台需分支处理信号逻辑。
-
Jaeger客户端初始化失败：span为空或上报无数据常见现象是调用tracer.StartSpan()后得到nil，或者服务跑起来但JaegerUI里完全看不到trace。根本原因通常是tracer没正确初始化，或初始化时漏了关键配置。必须在main函数早期、任何span创建前完成jaeger.NewTracer()调用，且返回值要赋给全局tracer变量（不能只声明不赋值）采样器配置别写死const，生产环境至少用probabilistic并设Samp
-
golangci-lint安装后commandnotfound是因未加入$PATH；macOS/Linux需将$HOME/go/bin加入~/.zshrc或~/.bashrc，Windows需手动添加%USERPROFILE%\go\bin到系统Path。
-
Go字符串原生支持Unicode，问题出在外部系统交互：MySQL需utf8mb4、JSON默认转义Emoji、len()返回字节数非字符数、HTTP响应头须声明charset=utf-8。
-
Go结构体是自定义复合类型核心，通过type声明、反引号标签（如json:"name"）附加元信息，并支持字面量、键值对、new()及&{}等多种初始化方式。
-
必须用goenv+.go-version锁定Go版本，显式设置GOOS/GOARCH，go.mod的go指令需与之严格对齐，禁用goget-u，统一gopls+.golangci.yml配置，CI中校验依赖树一致性。
-
gRPC接口定义必须用.proto文件，Go代码仅为生成结果；.proto是唯一权威来源，修改后须重新生成stub，否则报错或panic。
-
copy函数实现浅拷贝，仅复制元素值而不复制底层数组或递归处理指针字段；目标切片需预先分配空间，返回实际复制数，重叠时行为安全但需自行理清逻辑。
-
表驱动测试是Go中最推荐的单元测试组织方式，通过结构体切片集中定义测试用例并循环执行，提升可读性、可扩展性与可维护性。
-
gRPC要求显式import依赖的.proto文件，路径相对于--proto_path而非当前文件；多文件需一次性传给protoc生成代码；跨文件复用需避免循环引用和重复定义；包名由go_package等option统一控制。
-
GoLand中DatabaseNavigator连接失败主因是驱动未手动安装及URL缺少SSL禁用参数；表不显示需检查schema/权限并手动刷新；SQL执行需绑定数据源；结构变更后须右键单表刷新元数据。
-
最推荐使用goldmark库将Markdown转为HTML；它符合CommonMark标准、安全可配置、性能好，需显式注册extension.Table等扩展以支持表格和任务列表，并建议全局复用实例以提升Web服务性能。
-
最简安全下载需用http.Client设置超时，检查StatusCode，以io.Copy流式写入；带进度需分块读取并计算百分比；断点续传依赖Range头和Accept-Ranges；文件名优先取Content-Disposition，再清理非法字符防路径遍历。
-
Go1.17+官方二进制依赖GLIBC_2.18，而CentOS7自带glibc2.17，导致运行时报错；安全方案是在centos:centos7容器中编译，或禁用cgo静态链接，务必用file和ldd验证。
