# 项目配置说明

## GOPRIVATE 环境变量配置

由于本项目使用私有 Git 仓库 (`git.toowon.com`)，需要配置 `GOPRIVATE` 环境变量，让 Go 工具链知道这些模块是私有的，不要通过公共代理下载。

### 配置方法

#### 方法一：临时配置（当前终端会话有效）

```bash
# macOS/Linux
export GOPRIVATE=git.toowon.com

# Windows (PowerShell)
$env:GOPRIVATE="git.toowon.com"

# Windows (CMD)
set GOPRIVATE=git.toowon.com
```

#### 方法二：永久配置（推荐）

**macOS/Linux:**

1. 编辑 shell 配置文件（根据你使用的 shell 选择）：
   ```bash
   # 如果是 zsh（macOS 默认）
   nano ~/.zshrc
   
   # 如果是 bash
   nano ~/.bashrc
   # 或
   nano ~/.bash_profile
   ```

2. 添加以下内容：
   ```bash
   export GOPRIVATE=git.toowon.com
   ```

3. 保存文件并重新加载配置：
   ```bash
   # zsh
   source ~/.zshrc
   
   # bash
   source ~/.bashrc
   ```

**Windows:**

1. 打开"系统属性" -> "高级" -> "环境变量"
2. 在"用户变量"或"系统变量"中点击"新建"
3. 变量名：`GOPRIVATE`
4. 变量值：`git.toowon.com`
5. 点击"确定"保存

#### 方法三：使用 go env 命令（推荐，Go 1.13+）

```bash
# 设置 GOPRIVATE
go env -w GOPRIVATE=git.toowon.com

# 查看当前配置
go env GOPRIVATE

# 如果需要设置多个私有仓库，用逗号分隔
go env -w GOPRIVATE=git.toowon.com,github.com/your-org
```

### 验证配置

```bash
# 查看 GOPRIVATE 配置
go env GOPRIVATE

# 应该输出: git.toowon.com
```

### 其他相关环境变量（可选）

如果需要更细粒度的控制，还可以配置：

```bash
# GOPRIVATE: 私有模块，不通过代理下载，不校验 checksum
go env -w GOPRIVATE=git.toowon.com

# GONOPROXY: 不通过代理下载的模块（默认与 GOPRIVATE 相同）
go env -w GONOPROXY=git.toowon.com

# GONOSUMDB: 不校验 checksum 的模块（默认与 GOPRIVATE 相同）
go env -w GONOSUMDB=git.toowon.com
```

### Git 认证配置

由于是私有仓库，还需要配置 Git 认证：

#### 方法一：使用 SSH（推荐）

1. 确保已配置 SSH 密钥
2. 使用 SSH URL：
   ```bash
   git config --global url."git@git.toowon.com:".insteadOf "https://git.toowon.com/"
   ```

#### 方法二：使用 HTTPS + 个人访问令牌

1. 在 Git 服务器上生成个人访问令牌
2. 配置 Git 凭据：
   ```bash
   git config --global credential.helper store
   ```
3. 首次访问时会提示输入用户名和令牌

#### 方法三：在 URL 中包含凭据（不推荐，安全性较低）

```bash
# 在 go.mod 中使用（不推荐）
# 或者通过 .netrc 文件配置
```

### 常见问题

#### 问题1：go get 失败，提示找不到模块

**解决方案：**
1. 确认 GOPRIVATE 已正确配置
2. 确认 Git 认证已配置
3. 尝试手动克隆仓库验证：
   ```bash
   git clone git@git.toowon.com:jimmy/go-commom.git
   ```

#### 问题2：go mod download 失败

**解决方案：**
```bash
# 清除模块缓存
go clean -modcache

# 重新下载
go mod download
```

#### 问题3：IDE 无法识别模块

**解决方案：**
1. 重启 IDE
2. 在 IDE 中执行：`go mod tidy`
3. 确认 IDE 的 Go 环境变量配置正确

### 完整配置示例

```bash
# 1. 配置 GOPRIVATE
go env -w GOPRIVATE=git.toowon.com

# 2. 配置 Git SSH（如果使用 SSH）
git config --global url."git@git.toowon.com:".insteadOf "https://git.toowon.com/"

# 3. 验证配置
go env | grep GOPRIVATE

# 4. 测试模块下载
go get git.toowon.com/jimmy/go-commom@latest
```

### 参考文档

- [Go Modules 官方文档](https://go.dev/ref/mod)
- [Go 私有模块配置](https://go.dev/ref/mod#private-modules)