必须开启COS静态网站托管并使用cos-website域名访问，因默认域名自2024年1月起禁用HTML渲染，且普通上传不触发Web服务逻辑。
能直接部署，但必须走静态网站托管模式，不能当普通文件上传后用默认域名访问——2024年1月起 COS 默认域名已禁用直接渲染 HTML。
为什么上传了 index.html 还打不开页面？
上传后直接用 https://bucket-125xxx.cos.ap-guangzhou.myqcloud.com/index.html 访问，浏览器会弹出下载框，而不是渲染页面。这是因为 COS 默认把所有对象当二进制文件处理，不启用 Web 服务逻辑。
根本原因：COS 不是 Web 服务器，它只提供对象存储；要让 index.html 可被浏览器直接打开，必须显式开启「静态网站托管」功能，并使用对应的 cos-website 域名访问。
- 静态网站域名格式固定：
https://bucket-125xxx.cos-website.ap-guangzhou.myqcloud.com - 该域名仅在开启静态网站设置后才生效，且仅支持
GET请求（无后端逻辑） - 2024年1月后新建的存储桶，连这个
cos-website域名也需绑定自定义域名 + 备案（大陆节点）才能对外可访问
怎么开启静态网站并让 index.html 成为首页？
登录 COS 控制台 → 进入目标存储桶 → 左侧菜单点【基础配置】→ 找到【静态网站】→ 点【编辑】→ 开启状态，填入：
立即学习“前端免费学习笔记（深入）”；
-
索引文档：填index.html（必须完全匹配文件名，区分大小写） -
错误文档：可选填404.html或留空 - 其他项保持默认即可
保存后，立刻生效。此时用 cos-website 域名访问就能看到渲染后的页面，而非下载。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
注意：如果上传的是 pages/index.html 这类带子路径的结构，首页不会自动跳转；cos-website 不支持重写规则，必须确保请求路径与文件实际路径一致。
上传 index.html 时有哪些关键细节？
COS 对文件元数据敏感，尤其影响 HTML 渲染效果：
- 上传时务必勾选「设置 Content-Type」，手动指定为
text/html; charset=utf-8；否则可能被识别为binary/octet-stream，导致乱码或下载 - 文件权限必须设为「公有读」，否则即使开了静态网站，也会返回 403
- 不要压缩成 ZIP 后上传——COS 不解压，
index.html必须是顶层根目录下的独立对象 - 若本地开发用了相对路径引用 CSS/JS（如
./css/style.css），确保这些文件也上传到对应路径，且同样设对Content-Type
大陆节点 vs 海外节点：备案和延迟怎么权衡？
如果你用的是 ap-guangzhou、ap-beijing 这类中国大陆地域的存储桶：
- 绑定自定义域名（如
www.example.com）前，必须完成工信部 ICP 备案 - 备案需要云服务器（CVM）实名+白名单+审核周期，至少 1–2 周，且 CVM 本身产生成本
- 不备案就只能用
cos-website域名，但该域名在大陆公网无法直接解析（DNS 被拦截）
替代方案：直接选海外地域（如 ap-singapore、na-toronto），无需备案，cos-website 域名可直连。缺点是大陆用户首屏加载延迟高（200–600ms），但加一层 Cloudflare CDN 就能缓解——它免费提供缓存、HTTPS 和 DNS，且支持自定义域名零备案。
真正容易被忽略的一点：COS 静态网站不支持 HTTP/2 推送、不支持服务端重定向（301/302）、也不支持环境变量或构建时注入——它就是个纯文件托管，所有动态逻辑必须前端化（比如用 JavaScript fetch API 调用云函数）。
