# Go 语言学习与测试

用于学习 Go 基础语法、运行示例、编写单元测试和练习编译发布的个人学习仓库。

## 快速开始

安装 Go SDK 后，在本目录的终端执行：

```powershell
go version
go run .
```

预期输出：

```text
你好，Go！
欢迎开始 Go 语言学习与测试。
2 + 3 = 5
```

本项目仅使用 Go 标准库，**不需要安装第三方运行依赖**。完整安装步骤、工具依赖、编译运行方法及常见问题见 [安装与运行教程](./INSTALL.md)。

## 项目结构

```text
.
├── README.md       # 项目说明
├── INSTALL.md      # 安装、依赖、运行、测试与编译教程
├── go.mod          # Go 模块与工具链版本要求
├── main.go         # 第一个程序：输出、变量与加法函数
├── main_test.go    # Sum 函数的表驱动单元测试
└── .gitignore      # 忽略编译产物和本地配置
```

当前模块路径为 `example.com/go-study`，是本地学习用的模块标识，不需要注册域名，与 Git 远程地址可以不同。

## 常用命令

```powershell
# 编译并运行
go run .

# 格式化
go fmt ./...

# 单元测试与静态检查
go test -v ./...
go vet ./...

# 编译并运行 Windows 可执行文件
New-Item -ItemType Directory -Force bin | Out-Null
go build -o ./bin/hello.exe .
.\bin\hello.exe
```

`go run` 会先编译再运行；`go build` 生成可以单独启动的可执行文件。

## 学习路线

1. 读懂入口函数 `main`、导入语句 `import`、变量声明 `:=`。
2. 修改输出和加法函数，学习参数、返回值与类型。
3. 运行测试，为新函数补充更多测试用例。
4. 练习条件判断、循环、数组、切片和 map。
5. 继续学习结构体、接口、错误处理、文件与 JSON。
6. 最后学习 goroutine、channel 和简单 HTTP 服务。

后续独立练习建议分别放在 `cmd/hello`、`cmd/variables` 等子目录中，使用 `go run ./cmd/hello` 运行；不要在同一个包中重复声明 `main` 函数。

## 参考资料

- [Go 官方文档](https://go.dev/doc/)
- [A Tour of Go](https://go.dev/tour/)
- [标准库参考](https://pkg.go.dev/std)

## Git 仓库

远程地址：<http://vk-fly.com:10880/ZhuTianShuai/go_learn.git>

请勿将密码、访问令牌或个人环境配置提交到仓库。当前提供的是 HTTP 地址，不能提供 HTTPS 的传输加密；如服务端支持，建议后续改用 HTTPS 或 SSH。