JavaScript 设置 Cookie 的 Domain 属性需以点开头（如 .example.com）且为当前域名父域，不可为公共后缀；必须同注册域、启用 Secure 和 SameSite，并设 Path=/ 才能跨子域共享。
在 JavaScript 中设置 Cookie 的 Domain 属性，可以让顶级域名（如 example.com）及其子域名（如 www.example.com、api.example.com）共享同一个 Cookie。关键在于正确指定 Domain 值，并注意浏览器的安全限制。
Domain 属性的写法规则
Cookie 的 Domain 必须是当前页面域名的父域，且必须以点开头（如 .example.com），表示“该域名及所有子域名”。但不能设为公共后缀（如 .com、.co.uk），否则浏览器会拒绝存储。
- ✅ 正确：当前页是
www.example.com，设Domain=.example.com - ✅ 正确：当前页是
shop.example.com，设Domain=.example.com - ❌ 错误：设
Domain=com或Domain=.com - ❌ 错误：设
Domain=example.com（不带点前缀 → 仅限精确匹配，不继承到子域）
用 document.cookie 设置带 Domain 的 Cookie
JavaScript 通过 document.cookie 设置 Cookie 时，需手动拼接字符串，Domain 是其中的一个键值对：
document.cookie = "token=abc123; Domain=.example.com; Path=/; Expires=Wed, 01 Jan 2026 00:00:00 GMT; Secure; SameSite=Lax";
注意：Domain 值必须与当前页面同属一个注册域（registrable domain）。例如，从 sub.test.example.com 设置 Domain=.example.com 是允许的；但从 example.net 设置则会被浏览器忽略。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
Secure 和 SameSite 的配套建议
当跨子域共享 Cookie 时，安全风险上升，推荐同步启用以下属性：
- Secure：确保 Cookie 只通过 HTTPS 传输（生产环境必须加）
- SameSite=Lax（或 Strict）：防止 CSRF，同时保留大部分正常跳转场景下的 Cookie 发送能力
- Path=/：显式设为根路径，避免因路径不同导致子域读不到
验证是否生效的小技巧
设置后，可在不同子域下检查：
- 打开浏览器开发者工具 → Application → Cookies，看对应域名下是否有该 Cookie
- 在
www.example.com设置后，访问api.example.com并执行console.log(document.cookie)，确认能否读到token=... - 若读不到，检查控制台是否有 “Cookie X has been rejected” 类型的警告 —— 多半是 Domain 格式错误或跨了不同注册域
不复杂但容易忽略：Domain 前的点、HTTPS 环境、以及注册域一致性，三者缺一不可。
