-
Go包文档该写在哪儿才被godoc和VSCode正确识别Go不认README.md作为包文档——哪怕你写得再漂亮，godoc、godoc（或新版godoc命令）和大多数IDE都不会把它当包说明。真正起效的只有源码文件顶部的注释块。必须是紧贴package声明上方的「顶级注释块」，且中间不能空行注释必须是//开头的普通注释，不是/**/块注释（后者会被忽略）如果包有多个.go文件，只有一份注释生效：按字典序第一个含包注释的文件胜出别在main包里写长文档
-
ssh.Client.Dial报handshakefailed多因协议/算法不匹配，如OpenSSH8.8+禁用ssh-rsa而旧Go版本未启用rsa-sha2；应升级Go至1.18+或手动注册RSA-SHA2算法。
-
Go中访问者模式别扭源于无泛型约束与重载，需手动类型断言；应以接口组合+显式Accept实现替代Java式设计，用FuncVisitor简化维护，递归逻辑交由节点控制，并自行处理循环引用。
-
首先修改/usr/local/go目录所有权为当前用户，避免使用sudo安装工具；然后删除手动设置的GOROOT，确保PATH仅包含单一Go路径；最后将GOPATH设为用户目录并创建标准结构，确保权限与配置正确。
-
Go调用FFmpeg命令行是最现实的音视频处理方式，因标准库无支持且纯Go库功能残缺、维护停滞或性能差；推荐用os/exec直接调用，注意超时控制、stderr读取、绝对路径和避免Output()内存溢出。
-
Go语言通过value,ok:=interface{}.(Type)安全检视接口值的具体类型，非强制转换；支持typeswitch批量判断，仅适用于接口类型，断言开销小但需避免重复，nil接口断言依目标类型而定。
-
Go的io库通过Reader和Writer接口实现通用且强大的流式操作，其核心在于多态性和组合性。01.Reader接口的Read方法统一数据源，允许从不同来源读取字节流；02.Writer接口的Write方法统⼀数据目的地，支持灵活写入；03.通过组合多个Reader或Writer可构建复杂I/O管道，如缓冲、压缩、限流等；04.使用时需注意处理io.EOF、关闭Closer、管理缓冲区及应对部分读写；05.优化策略包括使用bufio包、预分配缓冲区、利用io.Copy及结合context控制超时；06
-
Go中数组是值类型，长度是类型的一部分，如[2]int与[3]int无关；赋值传参时全量拷贝，而切片[]int仅传递头信息；数组不可append、不能make创建，需用arr[:]转切片。
-
Go代码覆盖率需用gotest-coverprofile生成coverage.out再通过gotoolcover-html生成HTML报告查看具体覆盖情况，绿色为覆盖、红色为未覆盖、灰色为不可覆盖代码。
-
必须使用influxdb-client-go/v2官方SDK对接InfluxDB2.x，因协议层彻底变更：接口统一为/api/v2/、认证仅支持token；WriteAPI默认异步且错误静默，须调Flush()检查；Point时间戳不可为零值；bucket/org名严格匹配；Flux查询需显式yield()并正确处理多表结构。
-
Go允许n[0]=n这类赋值，是因为n[0]的类型N与n的类型[]N具有相同的底层类型[]N，且[]N是未命名类型，满足可赋值性规则。
-
Go语言通过encoding/csv和os包可便捷操作CSV文件。1.使用os.Create创建文件并用csv.NewWriter生成写入器；2.写入表头和数据行，支持单条Write或批量WriteAll；3.结构体需手动转为字符串切片，配合strconv处理非字符串字段；4.可设置writer.Comma自定义分隔符如制表符；5.必须调用writer.Flush确保数据写入磁盘。整个过程简洁高效，适用于数据导出等场景。
-
GitHubCopilot目前不支持Go语言的自动补全，因其模型缺乏Go语义理解，无法识别go.mod、interface{}和泛型约束，常输出Python/JS风格错误代码；需依赖gopls进行类型校验与补全。
-
配置GolangTLS开发环境需生成自签名证书（CN=localhost）、服务端用ListenAndServeTLS加载server.crt/server.key，客户端须将server.crt加入RootCAs；常见错误是CN/SAN不匹配或未配置RootCAs。
-
安装protoc编译器并配置PATH，通过goinstall安装protoc-gen-go插件，编写.proto文件后使用protoc--go_out=.生成Go代码，注意GOPROXY和PATH设置，推荐使用GoModules和新版google.golang.org/protobuf。
