-
根本原因是$PATH未包含Go二进制目录；Linux/macOS需将/usr/local/go/bin添加至~/.zshrc或~/.bash_profile并source，Windows需手动添加C:Gobin到系统Path环境变量。Go 二进制安装后为什么 go version 报 command
-
应弃用 gin.Default()，改用 gin.New() 手动注册中间件，将自定义 panic 捕获中间件置于首位，使用 c.AbortWithStatusJSON() 统一响应，区分业务 error 与 panic，避免中间件内未 recover 导致崩溃。默认的 gin.Default()
-
GoLand不校验命名长度，因其Code Style仅管格式；需用revive等linter配置max-name-length规则，并在.golangci.yml中启用、IDE中指定路径才生效。GoLand 本身不提供直接配置「变量名/函数名最小或最大字符数」的选项。命名长度属于语义规范，不在其内置
-
c.JSON()更安全，因自动设置Content-Type、状态码并处理json.Marshal()错误；手动用c.Data()+json.Marshal()易漏header、错status或panic。直接用 c.JSON()，别手写 json.Marshal() 再塞 c.Data()——Gin
-
GoLand 默认并不提供“按需折叠单个方法”这类开箱即用的能力，通常需要借助 //region 和 //endregion 手动把代码包起来；同时还得在设置里开启 Custom regions，确认当前文件类型识别无误，并且保证注释成对、书写严格对应，否则很容易出现折叠位置错乱的问题。GoLand
-
到了 Go 模块的 v2 及以上版本，目录必须明确改成 /v2，同时把 go.mod 和所有 import 路径一并更新到位；API 版本管理更推荐走路径前缀，而不是依赖 Accept 头；DTO 也要拆分清楚，保持独立定义；replace 只适合开发阶段使用，正式发布时必须改为 require 并
-
因为Gin每个请求在独立goroutine中执行，而count++非原子（读-加-写三步），并发时多个goroutine可能读到相同值并写回覆盖，导致计数丢失；应改用atomic.AddInt64(&count, 1)保证原子性。为什么 handler 里改全局变量会出错 问题就出在这里：Gin 处
-
Go 的 io.Pipe 没有内部缓冲，写端和读端必须在同一条消费链上配合推进。本文用一个压缩写入场景说明为什么 Write 会等待、CloseWithError 如何把失败传给另一端，以及怎样安排 goroutine 的退出和错误回收。
-
Go 泛型函数直接调用时通常可以省略类型参数，但一旦作为回调赋值、传参或返回值，类型推断依赖目标函数签名。本文用最小代码说明推断成功与失败的边界，并给出稳妥的显式实例化写法。
-
Go 1.26 让 new 函数可以直接接收表达式，适合构造 JSON 可选字段和配置指针。本文从旧写法、版本门槛、兼容回退和最小验证说明哪些代码值得改、哪些不该急着改。
-
Go 1.26 为 bytes.Buffer 增加 Peek 方法，可以在不推进读取位置的前提下预览前 N 个字节。本文对比 Next 和 Peek 的行为，说明 io.EOF、切片有效期、旧工具链兼容与测试边界。
-
Go 1.21 之后，工具链版本不只由机器上的 go 决定。用 go.mod、GOTOOLCHAIN 和 CI 矩阵配合，能把自动升级、固定版本和失败回退边界讲清楚。
-
Go 1.25 将 testing/synctest 从实验特性带入标准库。本文用一个带重试退避的缓存刷新器，演示 synctest.Test、synctest.Wait 和虚拟时间的配合，说明它适合什么测试、哪些网络边界仍要另想办法。
-
Go 的 json.Unmarshal 默认会忽略结构体中不存在的字段。本文用 Decoder.DisallowUnknownFields 给 HTTP JSON 接口加上字段契约，并说明兼容升级、错误定位和生产边界。
-
Go 1.26 为 runtime/pprof 增加了实验性的 goroutineleak profile，可以帮助发现因 channel、锁等并发原语永久阻塞的协程。本文用一个提前返回的收集器复现泄漏，说明启用开关、采样方式、误判边界和回滚检查。
