# GoSuda

> GoSuda is an open-source working group building high-performance networking, storage, runtimes, and developer tooling in Go.

- [Home](https://gosuda.org/zh/)
- [GitHub Organization](https://github.com/gosuda)
- [Full Markdown Corpus (llms-full.txt)](https://gosuda.org/llms-full.txt)
- [Agent Discovery Card (.well-known/agent-card.json)](https://gosuda.org/.well-known/agent-card.json)
- [RSS Feed](https://gosuda.org/zh/feed.rss)
- [Sitemap](https://gosuda.org/zh/sitemap.xml)

## Packages & Projects

- [Portal Tunnel：通过去中心化公共中继暴露本地主机服务](https://gosuda.org/zh/blog/posts/make-localhost-public-with-one-curl-—-portal-tunnel-z2f33ae49) ([Markdown](https://gosuda.org/zh/blog/posts/make-localhost-public-with-one-curl-—-portal-tunnel-z2f33ae49.md)): 通过一条 curl 命令，即可将本地 HTTP 服务暴露到公共互联网，借助多中继、无需许可的 Portal 隧道实现，无需注册账户，也无需安装二进制文件。
- [HQQ:通过缓存行共享内存将 C 库与 Go 隔离](https://gosuda.org/zh/hqq) ([Markdown](https://gosuda.org/zh/hqq.md)): 无 cgo 的 IPC 运行时、IDL 编译器（hqq-bindgen）以及经过验证的进程监督器，可在隔离的工作进程中通过共享内存环形缓冲区执行原生 C11 库。
- [Portal: 一种将本地服务中继至外部网络的端到端加密开放中继](https://gosuda.org/zh/portal) ([Markdown](https://gosuda.org/zh/portal.md)): 本文介绍 Portal 架构,该架构无需公网 IP 或云基础设施配置,即可通过端到端加密(E2EE)的开放式中继网络,将本地服务器暴露于外部互联网。
- [Portalite:基于多中继绑定与标准 net.Listener 的轻量级 Portal Go SDK](https://gosuda.org/zh/portalite) ([Markdown](https://gosuda.org/zh/portalite.md)): 这是一款轻量级的 Portal 客户端及命令行工具，它实现了 Go 标准库的 net.Listener 接口，支持同时绑定多个中继，提供端到端加密（E2EE），并具备自动会话恢复功能。
- [Randflake ID：基于 Sparx64 分组密码的分布式 64 位唯一 ID 生成](https://gosuda.org/zh/randflake) ([Markdown](https://gosuda.org/zh/randflake.md)): 基于分布式的64位唯一ID生成器,结合30位时间戳、17位节点ID、17位本地计数器,以及用于生成不可猜测ID的Sparx64 ARX分组密码。
- [Schottky：面向 Go 的零分配、保序字节键编码](https://gosuda.org/zh/schottky) ([Markdown](https://gosuda.org/zh/schottky.md)): 一个零分配的 Go 库,可将复合元组编码为可按 memcmp 排序的字节键,支持独立的升序/降序(ASC/DESC)排序、NULL 位置标记以及前缀扫描边界。
- [基于共享内存 IPC 的 gosuda.org/sqlite3：CGO_ENABLED=0 的 database/sql 驱动](https://gosuda.org/zh/sqlite3) ([Markdown](https://gosuda.org/zh/sqlite3.md)): 适用于 Go 的即插即用 database/sql SQLite 3.54.1 驱动程序，支持 CGO_ENABLED=0，具备 HQQ 共享内存工作进程隔离、64 KiB 批量行预取以及经 SLSA 认证的二进制文件。
- [gosuda.org/zstd：无需 CGO 且具备崩溃隔离的 DataDog/zstd 即插即用压缩库](https://gosuda.org/zh/zstd) ([Markdown](https://gosuda.org/zh/zstd.md)): CGO_ENABLED=0 的 Go Zstandard 库,在共享内存工作进程中运行上游 C 语言实现 libzstd 1.5.7,提供与 DataDog/zstd 兼容的 API、可复用上下文以及批量处理功能。

## Blog Posts

- [重新思考 Git 单体仓库:面向人类与编码智能体的 CAS 原生架构](https://gosuda.org/zh/blog/posts/rethinking-the-git-monorepo-a-cas-native-architecture-for-humans-and-coding-agents-zfd3d7931) ([Markdown](https://gosuda.org/zh/blog/posts/rethinking-the-git-monorepo-a-cas-native-architecture-for-humans-and-coding-agents-zfd3d7931.md)): 如何在标准 Git 之上构建一个零守护进程、CAS 原生的单体仓库：采用无父提交的主干快照、隔离的工作区引用、内存中的合并树、分层 OWNERS 机制，以及 O(delta) 镜像同步。
- [Go 1.27，或我如何学会不再担忧并爱上泛型方法](https://gosuda.org/zh/blog/posts/go-1-27-or-how-i-learned-to-stop-worrying-and-love-generic-methods-za800e454) ([Markdown](https://gosuda.org/zh/blog/posts/go-1-27-or-how-i-learned-to-stop-worrying-and-love-generic-methods-za800e454.md)): 泛型方法、encoding/json/v2、标准的 uuid 包，以及一个真正可用的 goroutine 泄漏检测器。本文带你快速浏览 Go 1.27，所有示例均已实际运行。
- [Go 条件语句(if)的 AMD64 汇编代码生成与分支指令分析](https://gosuda.org/zh/blog/posts/go-if-statement-analysis-3012d30c) ([Markdown](https://gosuda.org/zh/blog/posts/go-if-statement-analysis-3012d30c.md)): 本文比较了 Go 编译器将 if-else 条件语句转换为 CMPQ、JGE、JMP 等 AMD64 机器码分支指令的过程，以及 C 编译器（-O2）生成的分支代码结果。
- [托管语言的运行时结构与 Go 二进制文件 AMD64 汇编分析](https://gosuda.org/zh/blog/posts/managed-languages-intro-656b7470) ([Markdown](https://gosuda.org/zh/blog/posts/managed-languages-intro-656b7470.md)): 比较托管语言与非托管语言的执行模型,并通过 go tool objdump 提取的 AMD64 汇编,分析 Go 二进制文件中的栈检查及运行时函数调用结构。
- [AI 原生开发方法论:超越工具应用的双向上下文循环](https://gosuda.org/zh/blog/posts/ai-native-development-z86704c1a) ([Markdown](https://gosuda.org/zh/blog/posts/ai-native-development-z86704c1a.md)): 比较 AI 依赖型开发与单纯工具使用阶段的结构性局限,并定义一种双向积累设计意图与组织语境的 AI 原生开发流程。
- [香农信道容量极限与基于人工智能的语义通信(Semantic Communication)架构](https://gosuda.org/zh/blog/posts/the-next-communication-paradigm-led-by-ai-based-semantic-communication-zc1496ec7) ([Markdown](https://gosuda.org/zh/blog/posts/the-next-communication-paradigm-led-by-ai-based-semantic-communication-zc1496ec7.md)): 回顾香农-哈特利定理所给出的物理信道容量极限,并讨论语义通信:该方法借助共享知识库以及语义编码器/解码器,以语义单元而非比特为单位对传输数据进行压缩。
- [使用纯 Go 通过 syscall.Syscall 和 unsafe.Pointer 直接调用 Linux 系统调用](https://gosuda.org/zh/blog/posts/go-syscall-is-a-brilliant-replacement-of-low-level-i-o-za50951e1) ([Markdown](https://gosuda.org/zh/blog/posts/go-syscall-is-a-brilliant-replacement-of-low-level-i-o-za50951e1.md)): 在纯 Go 代码中不使用 cgo，通过 ABI 对齐的结构体、unsafe.Pointer 以及标准 syscall 包直接调用 SYS_SYSINFO 等 Linux 内核系统调用。
- [Any 不是 Any，但 Any 就是 Any](https://gosuda.org/zh/blog/posts/any-is-not-any-but-any-is-any-z6161856d) ([Markdown](https://gosuda.org/zh/blog/posts/any-is-not-any-but-any-is-any-z6161856d.md)): 详细分析 Go 语言的 `any` 类型及其内部 `EFace` 结构，并说明利用 `reflect` 包、类型断言和类型切换实现动态类型处理的方法。
- [Go 标准加密库中 FIPS 140-2 和 FIPS 140-3 的实现结构](https://gosuda.org/zh/blog/posts/fips-140-certification-and-golang-z0a59330a) ([Markdown](https://gosuda.org/zh/blog/posts/fips-140-certification-and-golang-z0a59330a.md)): 分析外部 C OpenSSL Provider 集成的局限性,并探讨从 BoringCrypto(FIPS 140-2)到原生 Go 标准 crypto 包的 FIPS 140-3 模式、Fail-Fast 验证、Hedged ECDSA 以及 DRBG 架构。
- [充满活力的位图](https://gosuda.org/zh/blog/posts/vibrant-bitmap-z1743872f) ([Markdown](https://gosuda.org/zh/blog/posts/vibrant-bitmap-z1743872f.md)): 从数据库位图索引的基本概念，到 Roaring Bitmap 的工作原理，再到 Go 语言中的应用方法。本文探讨面向大规模数据集高效处理的位图优化技术。
- [政治与计算机](https://gosuda.org/zh/blog/posts/politics-and-computers-zc4a4a358) ([Markdown](https://gosuda.org/zh/blog/posts/politics-and-computers-zc4a4a358.md)): 政治学与计算机科学，这两个看似不同却又颇为相似的领域，如何共同解决社会问题，以及开发者如何成为新的立法者，这些问题值得深入探讨。
- [Go 协程(Goroutine)的运行原理：2KB 可变栈与 M:N GMP 调度器](https://gosuda.org/zh/blog/posts/goroutine-basics-z3fbe209e) ([Markdown](https://gosuda.org/zh/blog/posts/goroutine-basics-z3fbe209e.md)): 从并发与并行的区别入手,阐述goroutine的2KB初始可变栈、用户级上下文切换、GOMAXPROCS,以及GMP(Goroutine-Machine-Processor)运行时调度模型。
- [数据库服务器与嵌入式数据库:架构及 I/O 特性比较](https://gosuda.org/zh/blog/posts/database-servers-and-embedded-databases-zd4cb799f) ([Markdown](https://gosuda.org/zh/blog/posts/database-servers-and-embedded-databases-zd4cb799f.md)): 从 NVMe SSD I/O 延迟、MSA 数据隔离和部署架构的角度，比较基于独立进程的 RDBMS 与 SQLite、RocksDB、BadgerDB、PebbleDB 等进程内嵌入式数据库。
- [Go 应用程序嵌入式 NATS 服务器的配置与进程内通信架构](https://gosuda.org/zh/blog/posts/how-embedded-nats-communicate-with-go-application-z36089af0) ([Markdown](https://gosuda.org/zh/blog/posts/how-embedded-nats-communicate-with-go-application-z36089af0.md)): 本文介绍如何在 Go 进程内部嵌入并运行 NATS 代理(nats-server/v2)的配置方法,并探讨基于 InProcessConn 的内存内通信以及消费者自定义接口的设计。
- [Go 接口与结构体嵌入:与类继承的区别及组合式设计](https://gosuda.org/zh/blog/posts/go-interfaces-are-not-inheritance-zd04c1084) ([Markdown](https://gosuda.org/zh/blog/posts/go-interfaces-are-not-inheritance-zd04c1084.md)): 比较 Java/C++ 类继承与 Go 接口的结构化类型(structural typing)之间的差异,并通过代码示例说明利用结构体嵌入(struct embedding)和方法委托(method delegation)实现的组合(Composition)模式。
- [从系统与后端工程视角看 Go 语言的 5 项设计特性](https://gosuda.org/zh/blog/posts/why-the-go-language-zdb70b280) ([Markdown](https://gosuda.org/zh/blog/posts/why-the-go-language-zdb70b280.md)): 本文围绕 Go 的设计哲学进行梳理,重点包括:快速的原生编译与执行性能、无需框架即可运行的标准库(net/http、database/sql)、M:N goroutine 调度器,以及向后兼容性的保证。
- [Go 运行时将夺走的一杯绿茶般的从容:GreenTea GC](https://gosuda.org/zh/blog/posts/greentea-gc:-the-respite-of-a-cup-of-green-tea-seized-by-the-go-compiler-z72acc3f7) ([Markdown](https://gosuda.org/zh/blog/posts/greentea-gc:-the-respite-of-a-cup-of-green-tea-seized-by-the-go-compiler-z72acc3f7.md)): Go 的新型 GreenTea GC 基于内存跨度(span)提升小对象的垃圾回收效率,从而改善性能。我们将探讨现有 GC 存在的问题以及 GreenTea GC 带来的优势。
- [Go HTTP 文件上传响应延迟优化:基于通道的异步工作池队列实现](https://gosuda.org/zh/blog/posts/go-handle-file-upload-with-concurrency-s844ce238) ([Markdown](https://gosuda.org/zh/blog/posts/go-handle-file-upload-with-concurrency-s844ce238.md)): 该结构通过缓冲通道和 goroutine 工作池，将 net/http 文件上传处理程序中的临时文件接收与 Incus 容器传输操作分离，从而降低端点的响应延迟。
- [Go 1.25 encoding/json/v2 行为变更及 v1 兼容层分析](https://gosuda.org/zh/blog/posts/go-1-25-encoding-json-v1-vs-v2-z74a36b08) ([Markdown](https://gosuda.org/zh/blog/posts/go-1-25-encoding-json-v1-vs-v2-z74a36b08.md)): 比较 Go 1.25 实验性功能(goexperiment.jsonv2)中引入的 encoding/json/v2 在大小写敏感匹配、omitempty/omitzero 语义变化、nil 切片/映射序列化及选项方面的差异。
- [Go 编译时变量注入:go build -ldflags -X 用法详解](https://gosuda.org/zh/blog/posts/compile-time-variable-injection-of-go-z5420556c) ([Markdown](https://gosuda.org/zh/blog/posts/compile-time-variable-injection-of-go-z5420556c.md)): 本文介绍如何在不使用外部 .env 文件的情况下，通过指定 go build -ldflags "-X" 链接器标志及包符号路径，在编译期注入 Go 字符串变量的值。
- [以更省心的方式处理 HTTP 错误 + RFC7807](https://gosuda.org/zh/blog/posts/handling-http-errors-more-conveniently-+-rfc7807-z862df968) ([Markdown](https://gosuda.org/zh/blog/posts/handling-http-errors-more-conveniently-+-rfc7807-z862df968.md)): Go API 错误处理很繁琐吗？使用 RFC7807 可以更简便、更清晰地处理错误。
- [LLM 代码生成环境中的语言设计比较:抽象成本与 Go 的显式性](https://gosuda.org/zh/blog/posts/modern-language-of-the-ai-era-z2d7204f1) ([Markdown](https://gosuda.org/zh/blog/posts/modern-language-of-the-ai-era-z2d7204f1.md)): 面向对象多态、语法糖以及复杂的模块树如何提高大语言模型的上下文推理成本进行了分析,并探讨了具有显式控制流和简洁语法的Go语言为何更适合人工智能代码生成。
- [Cilium 的故事:小小代码变更带来的惊人网络稳定性提升](https://gosuda.org/zh/blog/posts/cilium-story-small-but-effective-improvement-zd5a8e472) ([Markdown](https://gosuda.org/zh/blog/posts/cilium-story-small-but-effective-improvement-zd5a8e472.md)): 详细介绍 Cilium 项目中的一个小型代码变更如何显著提升了基于 LRU 的 NAT 连接管理的稳定性。
- [稍微了解一下 MCP host](https://gosuda.org/zh/blog/posts/a-little-understanding-of-mcp-host-zb952aae0) ([Markdown](https://gosuda.org/zh/blog/posts/a-little-understanding-of-mcp-host-zb952aae0.md)): 本文旨在帮助读者理解 Anthropic 的 MCP 协议以及用 Go 实现的 MCP 主机（mcphost）。
- [在 .NET Aspire 中尝试以可扩展的方式运行 Go 服务器](https://gosuda.org/zh/blog/posts/exploring-the-scalable-execution-of-go-servers-in-net-aspire-z42f3b6ee) ([Markdown](https://gosuda.org/zh/blog/posts/exploring-the-scalable-execution-of-go-servers-in-net-aspire-z42f3b6ee.md)): 如何使用 .NET Aspire 以可扩展方式运行 Go 服务器:结合 YARP 反向代理的水平扩展与自动化配置示例。
- [Go 语言中 MLDSA 与 MLKEM 的使用体验](https://gosuda.org/zh/blog/posts/usage-of-mldsa-and-mlkem-in-the-go-language-zb0442110) ([Markdown](https://gosuda.org/zh/blog/posts/usage-of-mldsa-and-mlkem-in-the-go-language-zb0442110.md)): 在 Go 语言中介绍后量子密码学 MLDSA 和 MLKEM 的使用方法，并阐述各算法的特点，同时提供代码示例。
- [Go 1.24 发布概述:Swiss Table 映射、ML-KEM、os.Root 与 testing/synctest](https://gosuda.org/zh/blog/posts/whats-new-in-go-1-24-z83ff24d2) ([Markdown](https://gosuda.org/zh/blog/posts/whats-new-in-go-1-24-z83ff24d2.md)): Go 1.24 技术概述:Swiss Table 内置映射、crypto/mlkem(FIPS 203)、TLS 加密客户端问候(Encrypted Client Hello)、runtime.AddCleanup、os.Root 以及 testing/synctest。
- [使用 Redis 客户端缓存提升响应性](https://gosuda.org/zh/blog/posts/improving-responsiveness-with-redis-client-side-caching-zb711e502) ([Markdown](https://gosuda.org/zh/blog/posts/improving-responsiveness-with-redis-client-side-caching-zb711e502.md)): 利用 Redis 服务器辅助的客户端缓存提升 API 响应性
- [使用 Go 与 Tcl/Tk 9.0 实现基于多文件列表框的图像查看器](https://gosuda.org/zh/blog/posts/creating-a-image-viewer-with-tk-in-go-z279238471Z) ([Markdown](https://gosuda.org/zh/blog/posts/creating-a-image-viewer-with-tk-in-go-z279238471Z.md)): 在 modernc.org/tk9.0 中添加 Tcl listbox 命令绑定和虚拟事件处理程序,以实现一个图形用户界面图像查看器,该查看器支持打开多个图像文件、切换选择以及删除列表项。
- [无需 CGo 的 Go Tcl/Tk(modernc.org/tk9.0)GUI 实现:控件打包与图像渲染](https://gosuda.org/zh/blog/posts/creating-a-gui-with-tk-in-go-z004dd008) ([Markdown](https://gosuda.org/zh/blog/posts/creating-a-gui-with-tk-in-go-z004dd008.md)): 在 Go 中实现窗口创建、按钮/菜单栏控件的打包以及 SVG/PNG/ICO 图像渲染，使用不依赖 CGo 的跨平台库 modernc.org/tk9.0。
- [Go 与 OpenAPI 生态系统](https://gosuda.org/zh/blog/posts/go-and-the-openapi-ecosystem-zd5a8e472) ([Markdown](https://gosuda.org/zh/blog/posts/go-and-the-openapi-ecosystem-zd5a8e472.md)): 介绍在使用 Go 语言进行基于 OpenAPI 的 API 开发时可以采用的库和策略。
- [Go 并发入门包](https://gosuda.org/zh/blog/posts/go-concurrency-starter-pack-z221a3399) ([Markdown](https://gosuda.org/zh/blog/posts/go-concurrency-starter-pack-z221a3399.md)): 本文介绍用于管理 Go 并发的各种工具和技术,包括 goroutine、channel、mutex 等。
- [Go 为何选择显式错误返回和 panic-recover，而不是 try-catch 异常抛出](https://gosuda.org/zh/blog/posts/why-doesn-t-go-have-try-catch-zeb312147) ([Markdown](https://gosuda.org/zh/blog/posts/why-doesn-t-go-have-try-catch-zeb312147.md)): 本文考察了沿调用栈传递异常处理责任的 try-catch 结构的局限性，并阐述了 Go 语言中的 panic-recover 设计：该机制将显式的 error 处理置于调用点，并将 panic 仅限于不可恢复的状态。
- [在 Go 中构建 AI 服务基础设施：并发与 API 集成](https://gosuda.org/zh/blog/posts/go-is-the-ideal-language-for-ai-applications-and-our-plans-to-make-it-even-better-z2f380165) ([Markdown](https://gosuda.org/zh/blog/posts/go-is-the-ideal-language-for-ai-applications-and-our-plans-to-make-it-even-better-z2f380165.md)): Go 如何处理基础模型 API 编排、并发网络 I/O、流式处理管道以及云原生服务部署。

## Localized Indexes

- [English (en)](https://gosuda.org/llms.txt)
- [Spanish (es)](https://gosuda.org/es/llms.txt)
- [Chinese (zh)](https://gosuda.org/zh/llms.txt)
- [Korean (ko)](https://gosuda.org/ko/llms.txt)
- [Japanese (ja)](https://gosuda.org/ja/llms.txt)
- [German (de)](https://gosuda.org/de/llms.txt)
- [Russian (ru)](https://gosuda.org/ru/llms.txt)
- [French (fr)](https://gosuda.org/fr/llms.txt)
- [Dutch (nl)](https://gosuda.org/nl/llms.txt)
- [Italian (it)](https://gosuda.org/it/llms.txt)
- [Indonesian (id)](https://gosuda.org/id/llms.txt)
- [Portuguese (pt)](https://gosuda.org/pt/llms.txt)
- [Swedish (sv)](https://gosuda.org/sv/llms.txt)
- [Czech (cs)](https://gosuda.org/cs/llms.txt)
- [Slovak (sk)](https://gosuda.org/sk/llms.txt)
- [Polish (pl)](https://gosuda.org/pl/llms.txt)
- [Romanian (ro)](https://gosuda.org/ro/llms.txt)
- [Hungarian (hu)](https://gosuda.org/hu/llms.txt)
- [Finnish (fi)](https://gosuda.org/fi/llms.txt)
- [Turkish (tr)](https://gosuda.org/tr/llms.txt)
- [Danish (da)](https://gosuda.org/da/llms.txt)
- [Norwegian (no)](https://gosuda.org/no/llms.txt)
- [Bulgarian (bg)](https://gosuda.org/bg/llms.txt)