-
Go 的 html/template 会按输出上下文自动转义普通字符串；只有经过明确 allowlist、来源受控的片段，才应在渲染前转换为 template.HTML。本文用一个小页面说明两者的边界、代码写法和验收清单。
-
Go 的 cgo 文件能否被识别，取决于 CGO_ENABLED、import C、同包目录、GOOS/GOARCH 和 go:build 约束。本文用 go list -json 查看 CgoFiles、CFiles 与 IgnoredGoFiles，定位文件未参与构建的具体层级。
-
Go 文件是否参与编译，不只看 //go:build，也要把 _GOOS、_GOARCH 或组合后缀带来的隐含条件一起判断。本文用 go list 区分 GoFiles 与 IgnoredGoFiles，并说明 -tags、gofmt 和 _test.go 的边界。
-
解释 Go html/template 为什么会对 URL 查询参数和路径片段做上下文转义，并区分正常百分号编码与不安全协议导致的 #ZgotmplZ。
-
Go generate 不会自动在 go test 前运行，这是 Go 工具链有意保留的职责边界。本文从 //go:generate 指令、生成文件和测试入口的关系出发，说明如何用显式命令或 CI 脚本稳定编排生成与测试，并排查生成缺失、版本漂移和失败传播问题。
-
用 Go text/template 的 Clone 复制公共模板命名空间，再为 Web 和邮件渠道追加独立 body 定义，掌握 ExecuteTemplate、并发执行与 HTML 安全边界。
-
Go text/template 遇到 map 缺字段时，可用 missingkey=default、zero 或 error 控制继续输出、返回零值或立即报错；本文说明三种规则的边界和 Execute 错误处理方式。
-
Go test -shuffle=on 能随机化测试和基准的执行顺序，并报告可复现的种子。本文用一个共享 map 的例子说明如何暴露顺序依赖、固定种子重放失败，以及用清理和独立夹具修复测试隔离问题。
-
Go text/template 的自定义函数要先放进 template.FuncMap，再通过 Funcs 绑定并 Parse 模板。本文说明注册时机、函数签名、管道调用、错误处理，以及解析后替换同名函数的边界。
-
解析 go test -json 时，关键不是逐行打印 JSON，而是按 Package 和 Test 保存事件流，再依据 Action 还原测试状态与输出。本文给出字段边界、并行处理和常见坑。
-
Go multipart boundary 缺失时，先检查 Content-Type 参数，再区分请求头、请求体和字段层问题；本文给出客户端发送与服务端诊断的可靠写法。
-
go test 在包列表模式下会复用成功的测试结果，看到 (cached) 时不一定代表测试二进制被重新运行。本文说明 go test -count=1 的适用场景、GODEBUG=gocachetest=1 的排查方法，以及测试缓存和构建缓存的区别。
-
Go 处理 multipart.FileHeader 时，FileHeader 只描述上传文件，真正需要关闭的是 Open 返回的 multipart.File；如果 ParseMultipartForm 把文件落到磁盘，还要在表单生命周期结束时调用 RemoveAll 清理临时文件。
-
Go 的 go、toolchain 指令和 GOTOOLCHAIN 并不是同一层配置：本文用实际选择场景拆开最低版本、建议版本、PATH 查找和自动下载的边界，帮助你稳定配置本地与 CI 工具链。
-
使用 Go 标准库 multipart.Writer 同时写入普通字段和文件字段，正确关闭 Writer、绑定带 boundary 的 Content-Type，并从资源、输入与审计角度排查上传请求问题。
