go 中的 map 本身是引用类型，直接传值即可修改其内容；传递 *map[string]t 反而会导致编译错误，因为指针不支持索引操作。正确做法是传 map 值，并在需要修改元素内部字段时，将 map 元素设为指针（如 map[string]*session）。

在 Go 中，map 是内置的引用类型（reference type），其行为类似于 slice、chan 和 func —— 它们底层都持有一个指向底层数据结构（如 hash table）的指针。因此，当你将一个 map 作为参数传递给函数时，实际上传递的是该引用的副本，但该副本仍指向同一底层数据结构。这意味着你*无需使用 `map[K]V` 指针类型**即可安全地增删改查 map 内容。

回到你的原始代码：

func refreshSession(sessions *map[string]Session) {
    now := time.Now()
    for sid := range *sessions {
        if now.After((*sessions)[sid].timestamp.Add(sessionRefresh)) { // ❌ 编译错误：*map 不支持索引
            delete(*sessions, sid)
        }
    }
}

这段代码报错的根本原因在于：*sessions 是一个指向 map 的指针（类型为 *map[string]Session），而 Go 不允许对指针类型做索引操作（即 ptr[key] 语法非法）。即使你解引用 (*sessions)[sid]，Go 编译器仍会拒绝——因为 (*sessions) 是一个 map 类型的值，但括号和运算符优先级导致语法解析失败（更准确地说，*sessions[sid] 被解析为 *(sessions[sid])，而 sessions[sid] 本身非法）。

Accessibility Review

对设计或页面进行 WCAG 2.1 AA 无障碍审计。触发关键词：“audit accessibility”、 “check a11y”、 “is this accessible?” 或在审查设计时使用。

下载

✅ 正确写法是直接传递 map 值，并按需调整 map 元素类型：

// 推荐：传 map 值，且 Session 字段需可变时，用 *Session
func refreshSession(sessions map[string]*Session) {
    now := time.Now()
    for sid, sess := range sessions {
        // 注意：sess 是 *Session，可直接修改其字段
        if now.After(sess.timestamp.Add(sessionRefresh)) {
            delete(sessions, sid)
        }
    }
}

⚠️ 关键注意事项：

• 若 Session 是值类型（如 struct），且你仅需读取字段（如 sess.timestamp），则 map[string]Session 也可工作，但 delete 和 range 仍完全有效；
• 但若需修改 session 内部字段（例如更新 sess.lastAccess），必须使用 map[string]*Session，否则 sess 是副本，修改无效；
• 绝对避免 *map[string]T：它既无必要，又引入复杂语法、降低可读性，还易引发编译错误；
• delete() 和 len() 等操作均作用于 map 值本身，与是否为指针无关。

? 总结：Go map 天然支持“按引用修改”，设计接口时应遵循 idiomatic Go 风格——简洁、直接、少用冗余指针。只需记住一句话：*“map is reference; map is not idiomatic.”**