Go官方中文文档唯一权威入口是go.dev/zh-cn,覆盖Go1.25及1.26,支持实时多语言切换;第三方中文网已停更滞后,安装无需手动配GOROOT/GOPATH,代理需加direct。

Go 官方中文文档在 2026 年已不再由 golang.org 提供独立维护,go.dev 是当前唯一权威的官方文档与学习入口,且**不提供单独的“中文文档网站”**——所有文档默认支持多语言切换,中文内容由 Go 团队直接翻译并同步更新,覆盖 Go 1.25 和即将发布的 Go 1.26。
go.dev 是唯一可信的中文文档源
过去曾有第三方托管的“Go 中文网”(如 golang-china.com),但自 2025 年底起已停止同步,部分页面仍可访问但存在严重滞后(例如泛型错误处理示例仍用 Go 1.18 语法)。官方明确要求:所有教学、工具链说明、API 文档均以 https://go.dev/doc/ 为准。中文切换方式很简单:
- 打开任意页面(如
https://go.dev/doc/install) - 右上角点击语言下拉框,选择「中文」
- URL 会自动变为
https://go.dev/zh-cn/doc/install,且内容与英文版严格对齐、实时更新
注意:go.dev/zh-cn 下的所有子路径(如 /tour、/play、/pkg)均支持中文,但 Playground(代码沙盒)界面语言取决于浏览器 Accept-Language,不随 URL 切换。
安装指南必须匹配 go.dev/doc/install 的当前版本
2026 年 Windows 用户最常踩的坑,是照着过时教程手动配置 GOROOT 和 GOPATH。实际上:
- Go 1.22+ 安装程序(
.msi)默认勾选「Add Go binaries to your PATH」,安装后GOROOT自动设为C:\Go,无需手动设置 -
GOPATH在模块模式(go mod)下已退化为缓存目录,默认值%USERPROFILE%\go,绝大多数项目完全不需要修改 - 验证只需一条命令:
go version输出含go1.25.6或go1.26.1即可,不必运行go env查看全部变量
若在国内下载慢,代理配置应写成:
go env -w GOPROXY=https://goproxy.cn,direct
注意结尾的 direct 不可省略,否则私有模块(如公司内网 Git)将无法拉取。
新手最容易忽略的 tour.go.dev 中文体验细节
https://go.dev/tour/ 是官方交互式教程,中文版已完整上线,但有几个关键点影响实操流畅度:
- 所有代码块右上角的「运行」按钮,实际调用的是本地
go run,不是服务器执行——这意味着你必须已安装 Go,且PATH正确 - 中文版中部分术语保留英文(如
goroutine、channel、defer),不是翻译遗漏,而是 Go 社区通用命名,代码中必须用英文 - 第 12 节「Web 服务器」示例中的
http.ListenAndServe默认绑定:8080,若端口被占用,需手动改写为":8081"再运行,页面不会提示冲突
建议第一次跑 tour 时,在终端先执行 go run . 确认本地环境无误,再回到浏览器点「运行」。
真正卡住人的往往不是语法,而是文档路径和本地环境的微小错位:比如把 go.dev/zh-cn 当成独立站点去收藏,结果某天发现链接 404——其实只是 Go 团队把旧版 tour 重定向到了新路径,而中文版 URL 结构没变。保持直接访问 go.dev 并从首页导航,是最稳的做法。











