Compare commits
2
Commits
86f6eb39b2
...
d45d713a50
| Author | SHA1 | Date | |
|---|---|---|---|
 labmem
|
d45d713a50 | ||
|
labmem
|
d375463de5 |
@@ -6,27 +6,33 @@
|
||||
|
||||
| 目录 | 说明 |
|
||||
|---|---|
|
||||
| `go/` | Go module `lab`（Go 1.26.2），go.mod 在该目录内 |
|
||||
| `go/` | Go 代码：`practice/` 是共用 module（`module lab`）的练习区，`projects/` 各项目为独立 module |
|
||||
| `note/` | 个人笔记（非代码），`note/项目/` 被 gitignore |
|
||||
| `dart/` | 预留，尚未建立 |
|
||||
|
||||
## Go 约定
|
||||
|
||||
- **Module 在 `go/` 目录下，不在仓库根**——所有 go 命令需在 `go/` 内执行
|
||||
- 每个叶子目录 = 一个独立小程序（`package main` + `main.go`）
|
||||
- 多个小程序可并存，不同目录、各自独立
|
||||
- 主题目录（basics/concurrency/stdlib/patterns/algorithms/web/testing/project）可随时增删
|
||||
- 测试文件用 `*_test.go`，运行单个测试：`cd go && go test ./testing/ -run TestSliceAppend`
|
||||
- Go 代码集中在 `go/`，目录本身不是 module，按用途分两区：
|
||||
- `go/practice/`——共用 module 的练习区，`go.mod` 在该目录内（见 [go/practice/README.md](go/practice/README.md)）
|
||||
- `go/projects/<项目名>/`——每个项目一个独立 module，自带 `go.mod`（见 [go/projects/README.md](go/projects/README.md)）
|
||||
- **go 命令在对应 module 的根目录执行**：练习代码在 `go/practice/` 内执行；projects 每个项目在自己的目录内执行
|
||||
- 练习区中每个叶子目录通常是一个独立小程序（`package main` + `main.go`），多个小程序并存互不冲突；库包（如算法实现）与只有测试文件的包也是合法形态
|
||||
- 主题目录可随时增删；写新程序时挑最贴的主题，在里面建一个新子目录
|
||||
- 测试文件用 `*_test.go`，运行单个测试：`cd go/practice && go test ./testing/slice -run TestSliceAppend`
|
||||
|
||||
## 开发命令
|
||||
|
||||
```
|
||||
# Go——所有命令在 go/ 目录下执行
|
||||
cd go
|
||||
go run ./<主题>/<程序名>/ # 运行单个程序
|
||||
go test ./... # 运行全部测试
|
||||
go test ./testing/ -v # 运行 testing 包测试
|
||||
go mod tidy # 整理依赖
|
||||
# Go 练习——在 go/practice/ 目录下执行
|
||||
cd go/practice
|
||||
go run ./basics/runtime/ # 运行单个程序
|
||||
go test ./... # 运行全部测试（部分练习阻塞/依赖环境，不保证全过）
|
||||
go test ./testing/... -v # 运行 testing 包及其子包测试
|
||||
go mod tidy # 整理依赖
|
||||
|
||||
# Go projects——在 go/projects/<项目名>/ 各自目录下执行
|
||||
go run . # 运行项目（按实际入口调整）
|
||||
go mod tidy # 整理依赖
|
||||
```
|
||||
|
||||
## 注意事项
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
|
||||
## 当前语言
|
||||
|
||||
- `go/` — Go（共用一个 module，约定见 [go/README.md](go/README.md)）
|
||||
- `go/` — Go（分 `practice/` 练习区与 `projects/` 项目区，约定见 [go/README.md](go/README.md)）
|
||||
- `dart/` — Dart
|
||||
- `ts/` — TypeScript / JavaScript（每个实验独立 npm 项目，约定见 [ts/README.md](ts/README.md)）
|
||||
|
||||
|
||||
+10
-20
@@ -1,24 +1,14 @@
|
||||
# Go 练习区
|
||||
# Go
|
||||
|
||||
本目录是 Go 的学习 / 练手代码，共用一个 module（`go.mod` 在本目录）。
|
||||
本目录按用途分两个区，`go/` 本身不是 module：
|
||||
|
||||
## 约定
|
||||
|
||||
- **每个叶子目录 = 一个独立小程序**：`package main` + `main.go`。
|
||||
- 多个小程序并存互不冲突（不同目录、各自的 `main`）。
|
||||
- 某个程序依赖太特殊时，可在它自己的目录单独 `go mod init`，脱离本 module。
|
||||
|
||||
## 主题目录
|
||||
|
||||
| 目录 | 放什么 |
|
||||
| 目录 | 定位 |
|
||||
|---|---|
|
||||
| `basics/` | 语法基础、内置类型（slice / map / chan 行为等） |
|
||||
| `concurrency/` | 并发：goroutine / channel / select / context |
|
||||
| `stdlib/` | 标准库练习（net/http、encoding/json、io…） |
|
||||
| `patterns/` | 设计模式 |
|
||||
| `algorithms/` | 数据结构与算法 |
|
||||
| `web/` | net/http、Gin 等框架 |
|
||||
| `testing/` | 练习 Go 测试机制（`*_test.go`、`go test`、table-driven、testify） |
|
||||
| `project/` | 完整小项目（多文件） |
|
||||
| [`practice/`](practice/README.md) | 练习区：共用一个 module（`go.mod` 在 `practice/` 内），语法 / 算法 / 测试等日常练手代码 |
|
||||
| [`projects/`](projects/README.md) | 项目区：每个子目录是独立 module 的完整小应用，自带 `go.mod`、自行管理依赖 |
|
||||
|
||||
> 主题目录可随时增删。写新程序时挑最贴的主题，在里面建一个新子目录放 `main.go` 即可。
|
||||
## 边界
|
||||
|
||||
- 写小段代码验证语言行为、练语法和标准库 → 放 `practice/` 对应主题目录。
|
||||
- 程序长成完整应用，或依赖需要独立于练习区管理 → 在 `projects/` 下新建目录，单独 `go mod init`。
|
||||
- 两个区互不包含：`practice/` 的 module 不覆盖 `projects/`，每个 projects 项目也是独立 module。
|
||||
|
||||
@@ -0,0 +1,35 @@
|
||||
# practice — 练习区
|
||||
|
||||
共用一个 module 的练手代码：`go.mod` 在本目录（`module lab`），所有日常练习都放这里。两区定位见 [../README.md](../README.md)。
|
||||
|
||||
## 约定
|
||||
|
||||
- 每个小程序 = 一个子目录：`package main` + `main.go`，多个小程序并存互不冲突（不同目录、各自的 `main`）。
|
||||
- 库包与测试包同样是合法形态：算法实现可以只提供库（如 `algorithms/linkedlist/`），`testing/` 下多为只有 `*_test.go` 的测试包。
|
||||
- 测试文件用 `*_test.go`，与被测代码同目录或独立成子包均可。
|
||||
- 程序长成完整应用、依赖需要独立管理时，移到 [`../projects/`](../projects/README.md) 单独 `go mod init`。
|
||||
|
||||
## 当前主题
|
||||
|
||||
| 目录 | 放什么 |
|
||||
|---|---|
|
||||
| `basics/` | 语法基础、内置类型行为（slice/map、runtime、pprof、goroutine 泄漏等） |
|
||||
| `algorithms/` | 数据结构与算法（含可复用的库包，如 `linkedlist/`） |
|
||||
| `testing/` | 练习 Go 测试机制，按点分子包：table-driven、regexp、net、crypto、json、error 等 |
|
||||
|
||||
主题目录可随时增删：想练并发、标准库、设计模式、Web 时，直接新建 `concurrency/`、`stdlib/`、`patterns/`、`web/` 等目录即可。
|
||||
|
||||
## 常用命令
|
||||
|
||||
以下示例从仓库根目录开始执行：
|
||||
|
||||
```bash
|
||||
cd go/practice
|
||||
go run ./basics/runtime/ # 运行单个程序
|
||||
go test ./... # 运行全部测试（不保证全过，见下方说明）
|
||||
go test ./testing/... -v # testing 包及其子包的全部测试
|
||||
go test ./testing/slice -run TestSliceAppend -v # 运行单个测试
|
||||
go mod tidy # 整理依赖
|
||||
```
|
||||
|
||||
> 注意：练习代码中含阻塞（如 channel 永久等待）或依赖环境（如反向 DNS）的测试示例，`go test ./...` 不保证全部通过；验证单个练习可用 `go test ./testing/slice -run TestSliceAppend`。
|
||||
@@ -0,0 +1,27 @@
|
||||
# projects — 独立 module 项目区
|
||||
|
||||
每个子目录是一个**完全独立的 Go module**，用于完整的小应用：自带 `go.mod`、自行管理依赖，与 [`../practice/`](../practice/README.md) 的共用 module 互不影响。是否该放这里见 [../README.md](../README.md)。
|
||||
|
||||
## 新建项目
|
||||
|
||||
以下命令从仓库根目录开始执行：
|
||||
|
||||
```bash
|
||||
mkdir go/projects/myapp && cd go/projects/myapp
|
||||
go mod init example.com/myapp
|
||||
```
|
||||
|
||||
`example.com/myapp` 仅为示例，需替换：本地练手可任意取名；打算对应真实仓库时按实际路径选择（如 `github.com/<用户名>/lab/go/projects/myapp`）。
|
||||
|
||||
之后按需创建 `main.go`（或 `cmd/<名>/main.go` 等布局）即可，不需要额外脚手架。
|
||||
|
||||
## 运行与维护
|
||||
|
||||
Go 命令一律在**该项目自己的目录**（module 根）下执行；以下示例从仓库根目录开始：
|
||||
|
||||
```bash
|
||||
cd go/projects/myapp
|
||||
go run . # 运行（按项目实际入口调整）
|
||||
go test ./... # 运行测试
|
||||
go mod tidy # 整理依赖
|
||||
```
|
||||
@@ -0,0 +1,3 @@
|
||||
module lyra
|
||||
|
||||
go 1.27.1
|
||||
Reference in New Issue
Block a user