# learn-go **Repository Path**: cjl2385/learn-go ## Basic Information - **Project Name**: learn-go - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-15 - **Last Updated**: 2026-11-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # learn-go 写给前端开发者(TS / React / Vue / Hono / NestJS)的 Go 课程,配一套可交互的 API 手册 ## 开始 ```bash go run ./lab # 打开 http://127.0.0.1:8081 LAB_ADDR=10.0.0.4:8081 go run ./lab # 绑定到指定网卡地址(启动时打印带 token 的访问链接) bun run lab:host # 通配监听,启动时打印本机 IPv4 的带 token 链接 ``` 整个项目只需要启动这一个服务,不用另开静态服务器。lab 同时托管页面和演示接口。页面里的演示会请求 Go 后端,看到的是真实运行结果;练习区可以改代码后直接运行。直接双击 HTML 也能读,演示区显示快照 系统难题篇(第 22 课起)的演示和测试还需要 Postgres + Redis 容器,第 42 课另需从库(`replica` profile)。容器数据放 tmpfs,停掉即清空,用到时自动重建 ```bash docker compose -f infra/compose.yml up -d --wait # 主库 + Redis docker compose -f infra/compose.yml --profile replica up -d --wait # 再加从库(第 42 课) docker compose -f infra/compose.yml --profile replica down # 全部停止 ``` 同样的命令在 `package.json` 里有短名,用 `bun run <名字>` 执行: | 脚本 | 作用 | | --- | --- | | `dev` | 启动主库 + Redis,再前台运行 lab(127.0.0.1) | | `dev:wg` | 启动全部容器(含从库),lab 监听 `10.0.0.4:8081` | | `lab` / `lab:wg` / `lab:host` | 只运行 lab;`lab:host` 通配监听并启用随机访问令牌 | | `infra:up` / `infra:up:replica` | 只启动容器 / 含从库 | | `infra:down` | 停止并删除全部容器 | | `infra:ps` | 查看容器状态 | | `test` | `go vet` + `go test ./...`(需先启动容器) | lab 在前台运行,`Ctrl+C` 停止;容器要单独 `infra:down` ## 目录 ``` learn-go/ ├── index.html # 导航:课程 / API 手册 ├── lab/ # 本地服务:静态页面 + /api/... 演示接口 + /api/run ├── lessons/ # 课程,每课一个目录:源稿、HTML、示例代码、测试、演示接口 ├── reference/ # API 手册,按包分组 ├── appendix/ # 避坑速查、生态地图 ├── internal/labkit # 演示接口的公共约定 ├── go-backend/ # 毕业项目:Chi + Huma + GORM + Postgres 后端样板(独立 module) ├── OUTLINE.md # 系统难题篇(第 22–49 课)大纲与进度 └── STYLE.md # 写作与制作规范 ``` 课程地图见 `STYLE.md` 第 8 节,系统难题篇见 `OUTLINE.md` ## 环境 - Go 1.26+(`mise use -g go@1.26`) - 国内网络:`go env -w GOPROXY=https://goproxy.cn,direct` - 重新渲染页面需要 bun 和 answer-with-html skill,步骤见 `STYLE.md` 第 7 节 ## 关于 /api/run `/api/run` 会在本机编译运行提交的 Go 代码,只用于本地学习。lab 默认只监听 127.0.0.1。显式设置 `LAB_ADDR` 绑定非 loopback 地址(包括通配地址)时,启动会生成随机访问令牌并打印访问链接;首次用链接打开会换成 HttpOnly、SameSite=Strict cookie,之后页面与 API 均需授权。令牌不写入请求日志。HTTP 不加密,令牌不能防网络嗅探;只在可信网络(如自己的 WireGuard)里使用,不要转发到公网。默认本机模式校验 Host 以防 DNS 重绑定,所有模式拒绝跨 Origin,POST 只接受 `application/json`。所有 `/api` 路径也会检查 Fetch Metadata:只接受 `Sec-Fetch-Site: same-origin`,拒绝 `cross-site`、`same-site`、`none` 等其它浏览器请求状态,因此跨站图片 GET、顶级导航与表单请求都不能触发 API。缺少该头的非浏览器调用(如 curl)仍兼容;同源浏览器 fetch 正常放行