Go 函数返回结构体切片时，常见错误是误用指针语法（如 *[]User），导致仅访问到单个元素；根本原因在于 slice 本身已是引用类型（含底层数据指针、长度与容量三元组），无需额外取地址，且 *[]User 表示“指向切片的指针”，语义错误且极易引发越界或 panic。
go 函数返回结构体切片时，常见错误是误用指针语法（如 `*[]user`），导致仅访问到单个元素；根本原因在于 slice 本身已是引用类型（含底层数据指针、长度与容量三元组），无需额外取地址，且 `*[]user` 表示“指向切片的指针”，语义错误且极易引发越界或 panic。
在 Go 中，[]User 并非值类型，而是一个轻量级描述符结构体——它内部包含三个字段：指向底层数组的指针（*User）、当前长度（len）和容量（cap）。这意味着当你将 []User 作为返回值传递时，实际拷贝的仅是这 24 字节（64 位系统下）的元信息，而非整个用户数据；因此无需、也不应对其取地址。
你原函数中的问题核心有两处：
错误的返回类型：
func() (*[]User, error)声明返回的是「指向切片变量的指针」，即&users的地址。但users是一个局部变量（栈上分配），其生命周期仅限于函数作用域；返回&users后，该地址所指的 slice 头部结构可能已被复用或覆盖，造成未定义行为。更严重的是，调用方解引用*users得到的仍是那个已失效的 slice 头，len(*users)可能被破坏为1，导致只“看到”一个元素——这正是你日志中仅打印出 1 个用户的原因。不匹配的数据接收方式：
datastore.GetAll的签名要求传入*[]User（即指向切片的指针），目的是让函数能修改该切片变量本身（例如重分配底层数组并更新其指针/长度）。但你的users是[]User类型，&users才是*[]User；而若你改为直接返回[]User，则需确保GetAll被正确调用（见下文修正）。
✅ 正确做法如下：
方案一（推荐）：直接返回 []User，并正确调用 GetAll
func (db *datastoreDB) GetAllUsers(ctx context.Context) ([]User, error) {
query := datastore.NewQuery("User")
var users []User // ← 声明空切片（len=0, cap=0）
keys, err := db.client.GetAll(ctx, query, &users) // ← 必须传 &users！因 GetAll 需修改切片头
if err != nil {
return nil, err
}
return users, nil // ← 直接返回切片值（安全、高效、符合 Go 惯例）
}
调用方：
users, err := models.DB.GetAllUsers(ctx)
if err != nil {
log.Fatal(err)
}
log.Printf("Found %d users", len(users)) // ✅ 正确获取长度
for i, u := range users {
log.Printf("User %d: %s", i, u.username) // ✅ 安全遍历
}
⚠️ 关键点：datastore.GetAll 的第三个参数必须是 *[]User 类型（即 &users），因为它需要写入新的底层数组地址和长度；但函数自身应返回 []User，而非 *[]User。
方案二：若需返回指针切片（如避免复制大结构体）
当 User 结构体非常大，或你希望调用方能修改原始实例（而非副本）时，可返回 []*User：
func (db *datastoreDB) GetAllUsersPtr(ctx context.Context) ([]*User, error) {
query := datastore.NewQuery("User")
var users []*User
keys, err := db.client.GetAll(ctx, query, &users)
return users, err // users 已是 []*User，直接返回
}
此时 users[i] 是 *User 类型，可通过 users[i].username 直接访问字段（Go 自动解引用）。
? 指针符号速查表：
| 写法 | 含义 | 是否常用 | 风险提示 |
|------|------|----------|-----------|
| []User | 切片（引用类型） | ✅ 极常用 | 安全，零拷贝传递 |
| *[]User | 指向切片变量的指针 | ❌ 禁止用于返回局部切片 | 悬空指针，未定义行为 |
| []*User | 切片，每个元素是指向 User 的指针 | ⚠️ 按需使用 | 内存稍多，但支持原地修改 |
| *User | 指向单个 User 的指针 | ✅ 常用于方法接收器或大结构体 | 需确保所指对象生命周期足够长 |
? 总结：Go 的 slice 设计哲学是「值语义，引用实现」。牢记 “slice 本身不是指针，但它内部包含指针” —— 因此永远不要对 slice 取地址来“优化性能”，那只会引入 bug。真正需要优化时，应审视 User 结构体设计（如是否冗余字段）、或改用 []*User 显式管理对象生命周期。最后，请务必阅读 Go 博客：Slices 使用与内部原理，这是理解本问题的基石。
