Revel中读取Cookie必须用c.Request.Cookie()并检查error，写入和删除需用http.SetCookie()，Session与普通Cookie是两套机制。
Revel 中读取 Cookie 的正确方式是 c.Request.Cookie()
Revel 没有提供类似 c.Cookie.Get() 的封装方法，必须直接操作标准库的 http.Request。调用 c.Request.Cookie("name") 会返回 *http.Cookie 和 error；如果 Cookie 不存在或解析失败，err != nil，此时不能假设值为空字符串——它根本没被设置。
常见错误是忽略 error 直接取 cookie.Value，导致 panic：
// ❌ 危险写法：未检查 err
cookie, _ := c.Request.Cookie("theme") // 第二个返回值被丢弃
c.RenderArgs["theme"] = cookie.Value // 若 cookie 不存在，cookie == nil → panic
<p>// ✅ 正确写法：必须检查 err
cookie, err := c.Request.Cookie("theme")
if err != nil {
c.RenderArgs["theme"] = "light" // 默认值
} else {
c.RenderArgs["theme"] = cookie.Value
}
-
c.Request.Cookie()只读取原始请求头中的 Cookie，不经过任何解密或校验（Revel 的 Session 是加密签名的，但普通 Cookie 不是） - 浏览器发送的 Cookie 是以
key=value形式拼接在Cookie请求头里的，Request.Cookie()会按分号分割并匹配 key - 若 Cookie 名含点号（如
user.id），部分旧版浏览器可能截断，建议用下划线代替
Revel 中写入 Cookie 必须用 http.SetCookie()，不是 c.Session
c.Session 是 Revel 封装的、带签名和加密的会话机制，只用于用户状态管理；普通业务 Cookie（如偏好设置、追踪 ID、AB 测试分组）应走标准 HTTP Cookie 流程，由 http.SetCookie() 控制。
示例：设置一个 7 天有效期的深色模式标记
http.SetCookie(c.Response.Out, &http.Cookie{
Name: "theme",
Value: "dark",
Path: "/",
MaxAge: 7 * 24 * 3600,
HttpOnly: false,
Secure: c.Request.TLS != nil, // 开发环境可设 false，生产务必 true
SameSite: http.SameSiteLaxMode,
})
-
c.Response.Out是底层http.ResponseWriter，SetCookie会向响应头写入Set-Cookie - 不要用
c.Session["theme"] = "dark"代替——这只会把值塞进加密 session cookie，无法被前端 JS 读取（HttpOnly默认开启），也不符合语义 -
MaxAge优先于Expires；设为 0 表示会话级 Cookie（关闭浏览器即失效）；负数表示立即过期（用于删除）
删除 Cookie 要显式设 MaxAge=0 或 Expires=past
Revel 没有 c.Cookie.Delete() 这样的快捷方法。删除本质是让浏览器清掉对应 key，必须下发一条“过期”的 Set-Cookie 响应头。
// ✅ 正确删除方式（推荐 MaxAge=0）
http.SetCookie(c.Response.Out, &http.Cookie{
Name: "tracking_id",
Value: "",
Path: "/",
MaxAge: 0, // 关键：设为 0，浏览器立即丢弃
HttpOnly: true,
Secure: c.Request.TLS != nil,
})
<p>// ✅ 等效写法（Expires 设为过去时间）
http.SetCookie(c.Response.Out, &http.Cookie{
Name: "tracking_id",
Value: "",
Path: "/",
Expires: time.Unix(1, 0), // Unix 时间戳 1 秒（1970-01-01 00:00:01）
HttpOnly: true,
Secure: c.Request.TLS != nil,
})
- 仅调用
delete(c.Session, "key")对普通 Cookie 完全无效——Session 和普通 Cookie 是两套机制 - Value 设为空字符串是安全的；设为
"deleted"或其他值仍会被浏览器保留，除非 MaxAge/Expires 生效 - Path 必须与写入时一致，否则浏览器认为是不同 Cookie，不会覆盖删除
注意 Cookie 域名和路径匹配规则，跨子域共享需显式配置 Domain
默认情况下，Cookie 的 Domain 是当前主机名（不含端口），且不允许跨子域。例如 api.example.com 写的 Cookie，www.example.com 读不到。
若需 example.com 及其所有子域共享，写入时必须指定 Domain=".example.com"（开头带点）：
http.SetCookie(c.Response.Out, &http.Cookie{
Name: "auth_token",
Value: token,
Path: "/",
Domain: ".example.com", // 注意开头的点
MaxAge: 3600,
HttpOnly: true,
Secure: true,
SameSite: http.SameSiteStrictMode,
})
-
Domain=".example.com"允许www.example.com、api.example.com等子域读写 - 但
Domain="example.com"（无点）在现代浏览器中会被拒绝，视为无效 - 开发时用
localhost无法设Domain（浏览器策略限制），测试跨域 Cookie 需用真实域名或127.0.0.1
Revel 的 Cookie 操作本质就是 Go 标准库的 http.Request 和 http.ResponseWriter 接口，没有魔法封装。最容易被忽略的是：Session 不等于 Cookie，c.Session 的增删对普通 Cookie 完全无影响；而普通 Cookie 的生命周期、域、路径等细节，一旦写错就无法被浏览器正确识别或删除。
