github codespaces 运行 go 项目需手动配置 devcontainer.json：显式声明 go feature 安装二进制、执行 go mod init 初始化模块、设置 goproxy 加速依赖拉取、添加 delve feature 启用调试，否则将报 command not found 或 no required module provides package。
GitHub Codespaces 能直接跑 Go 项目，但默认环境不带 go 命令，也不自动启用 Go Modules，必须手动配 devcontainer.json，否则 go run 会报 command not found 或 no required module provides package。
Codespaces 默认没有 Go 环境
新建 codespace 后执行 go version 大概率返回 bash: go: command not found。GitHub 官方 Ubuntu 镜像（如 ghcr.io/devcontainers/feature/ubuntu:22.04）不预装 Go，哪怕你选了 “Go” 模板，也只是加了部分插件，没装二进制本身。
- 最稳妥方式：在
.devcontainer/devcontainer.json的features里显式声明 Go 版本，例如："ghcr.io/devcontainers/features/go:1"（自动安装最新稳定版）或指定"version": "1.22" - 别用
apt-get install golang手动装——Ubuntu 仓库的 Go 版本老旧（常为 1.19），且可能和GOPATH冲突 - 如果已有
devcontainer.json但没配 Go feature，codespace 启动后go不可用，必须重建容器才能生效
Go Modules 必须显式初始化
即使 go 命令可用，go run main.go 仍可能失败，报错类似 no required module provides package。这是因为 Codespaces 不会自动帮你 go mod init，尤其当你从空目录或非模块历史仓库启动时。
审计 GitHub Actions 工作流文件的密钥泄露风险，例如 pull_request_target 密钥使用、密钥回显命令及未固定版本的 Action 密钥传递。
- 首次打开项目前，确保根目录下有
go.mod文件；没有就手动运行go mod init example.com/myapp（模块路径可任意，但建议与未来 import 路径一致） - 如果项目已存在
go.mod，但 codespace 启动后go list -m显示为空，检查GO111MODULE=on是否生效（Codespaces 默认开启，但某些自定义镜像可能关掉） - 避免在
$HOME下直接写 .go 文件——Go 会拒绝在非模块路径下运行，错误提示极简，容易误判为语法问题
云端编译快，但依赖拉取慢是常见瓶颈
Codespaces 的 CPU 和磁盘 IO 满足编译需求，但首次 go build 或 go test 往往卡在 go: downloading 阶段，尤其依赖私有模块或国内网络访问 proxy.golang.org 不稳定。
- 在
.devcontainer/devcontainer.json的customizations.vscode.settings中设代理："golang.goproxy": "https://goproxy.cn,direct"（CN 用户推荐） - 若用私有模块（如 GitHub 私仓），需提前在 codespace 中配置 SSH key 或
git config --global url."https://oauth2:TOKEN@github.com".insteadOf "https://github.com" -
go build -i（缓存中间对象）在云端意义不大——codespace 生命周期短，重启即丢缓存；不如专注优化go mod download一次性拉全依赖
调试器要额外启用 Delve
VS Code 的 Go 扩展在 Codespaces 中默认不激活调试功能，点击 ▶️ 运行按钮只会调 go run，无法断点、变量查看或热重载。
- 必须在
.devcontainer/devcontainer.json的features中加入 Delve："ghcr.io/devcontainers/features/delve:1" - 确保
.vscode/launch.json存在且配置正确，典型内容：{"name": "Launch Package","type": "go","request": "launch","mode": "auto","program": "${workspaceFolder}"} - Delve 启动时会监听本地端口（如
dlv --headless --listen=:2345），Codespaces 自动做端口转发，但若手动改过listen地址（如绑127.0.0.1:2345），会导致 VS Code 连不上
真正麻烦的不是装 Go，而是每次重建 codespace 后，go mod download 和 dlv 初始化都得重走一遍——没做 cacheFrom 或 postCreateCommand 优化的话，前三分钟基本在等网络。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
