# go_usage_example

**Repository Path**: Xeroo/go_usage_example

## Basic Information

- **Project Name**: go_usage_example
- **Description**: GO 语言使用示例
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-01
- **Last Updated**: 2026-09-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Go 基础用法与应用示例

本项目面向“有其他语言编程经验，但刚开始学习 Go”的读者。所有示例均只使用 Go 标准库，并在 Go 特有或容易误解的地方添加了中文注释。

## 目录

- `usage/`：按知识点分类的语言基础与标准库示例。
- `example/`：可以直接运行的小应用，每个应用有自己的说明。

## 准备环境

安装 Go 1.22 或更高版本，然后在项目根目录执行：

```bash
go version
go test ./...
```

运行某个示例时，把目录传给 `go run`：

```bash
go run ./usage/01-basics
go run ./example/http-server
```

建议按目录编号依次阅读 `usage`。示例刻意保持短小，重点是展示语法和惯用写法，而不是构建完整框架。

## 示例索引

| 目录 | 内容 |
| --- | --- |
| `usage/01-basics` | 变量、常量、基本类型、条件和循环 |
| `usage/02-collections` | 数组、切片、map、range |
| `usage/03-functions` | 多返回值、可变参数、闭包、defer |
| `usage/04-structs-interfaces` | 结构体、方法、组合、接口 |
| `usage/05-errors` | 错误创建、包装、检查和自定义错误 |
| `usage/06-pointers` | 指针和值/指针接收者 |
| `usage/07-generics` | 泛型函数和类型约束 |
| `usage/08-concurrency` | goroutine、channel、select、context |
| `usage/09-io-json` | Reader/Writer、文件和 JSON |
| `usage/10-testing` | 表驱动测试和基准测试 |
| `example/http-server` | REST 风格 HTTP 服务 |
| `example/https-server` | HTTPS 服务及本地证书生成器 |
| `example/websocket-server` | 无第三方依赖的 WebSocket 回显服务 |
| `example/cli` | flag 命令行程序 |
| `example/tcp-server` | TCP 并发回显服务器 |

> 服务示例默认只适合本地学习。部署到公网前还需补充认证、限流、日志、安全配置和优雅停机等生产能力。