2. 环境搭建与项目初始化

在开始构建分布式鉴权系统之前，必须搭建一套标准、可复现的开发环境。本章将指导你完成从 Go 语言安装到 Ent CLI 配置的全流程，确保后续章节的代码能够无缝运行。

2.1 Go 语言环境配置

Ent 要求 Go 版本 ≥ 1.21。推荐使用 Go 1.22+ 以获取最新的泛型支持和性能优化。

操作系统	安装方式	验证命令
macOS	brew install go	go version
Ubuntu/Debian	下载 .tar.gz 解压至 /usr/local	go version
Windows	MSI 安装包 / winget install GoLang.Go	go version

2.2 初始化 Go Module

每个 Ent 项目都应以独立的 Module 开始。我们创建一个名为 ent-auth-demo 的项目目录并初始化模块。

mkdir ent-auth-demo
cd ent-auth-demo
go mod init github.com/yourname/ent-auth-demo

初始化后，项目根目录会生成 go.mod 文件。建议立即设置 Go 代理以加速依赖下载：

go env -w GOPROXY=https://goproxy.cn,direct   # 国内用户推荐
go env -w GOPROXY=https://proxy.golang.org,direct  # 国际用户

2.3 安装 Ent CLI 与核心依赖

Ent CLI 是代码生成器，负责从 Schema 定义生成数据库操作代码。安装命令如下：

go install entgo.io/ent/cmd/ent@latest

验证安装：

ent version

输出示例：

ent v0.14.1

接下来，在项目内安装 Ent 运行时库和数据库驱动。本课程以 PostgreSQL 为主，同时兼容 SQLite 用于本地测试。

go get entgo.io/ent@latest
go get github.com/lib/pq          # PostgreSQL 驱动
go get github.com/mattn/go-sqlite3 # SQLite 驱动（可选）

2.4 初始化 Ent Schema 骨架

使用 Ent CLI 的 init 命令生成第一个 Schema 文件。该文件是后续定义鉴权模型（User、Role、Permission）的起点。

ent init User

执行后，项目结构如下：

ent-auth-demo/
├── go.mod
├── go.sum
├── ent/
│   ├── generate.go
│   └── schema/
│       └── user.go       # 待编辑的 Schema 文件
└── ...

generate.go 文件内容固定，用于触发代码生成：

package ent

//go:generate go run -mod=mod entgo.io/ent/cmd/ent generate ./schema

2.5 验证代码生成

在 ent/schema/user.go 中添加一个简单的字段，然后运行生成命令，验证环境是否正常工作。

// 编辑 ent/schema/user.go
package schema

import (
    "entgo.io/ent"
    "entgo.io/ent/schema/field"
)

type User struct {
    ent.Schema
}

func (User) Fields() []ent.Field {
    return []ent.Field{
        field.String("username").Unique(),
        field.String("password_hash"),
    }
}

执行生成：

go generate ./ent

成功时，ent/ 目录下会生成 client.go、user.go、user_create.go 等文件。若出现错误，请检查 Go 版本和依赖完整性。

2.6 环境架构总览

下图展示了开发环境中各组件的关系：

2.7 环境检查清单

完成上述步骤后，使用以下清单确认环境就绪：

• Go 版本：go version ≥ 1.21
• Module 初始化：项目根目录存在 go.mod
• Ent CLI：ent version 输出正常
• 依赖安装：go list -m all | grep ent 显示 ent 包
• 代码生成：go generate ./ent 无报错，ent/client.go 已生成