HTML文件本地双击仅支持纯静态页面;涉及fetch、XMLHttpRequest等功能必须用本地服务器(如Python http.server或VS Code Live Server)运行,线上推荐GitHub Pages、Vercel或Netlify一键部署。

HTML编辑器本身不负责发布,它只生成文件;真正让网页“上线”的是把 index.html 和配套资源(css/、js/、images/)放到能响应 HTTP 请求的服务器上。本地双击打开只是 file:// 协议,浏览器会禁用跨域、fetch()、字体加载等关键能力——这不是网页,只是草稿。
为什么 GitHub Pages 是最省事的起点
它不要求你装软件、配环境、记命令,只要你会用 Git 提交代码,就能获得一个带 HTTPS 的公开网址。适合作品集、个人介绍页、文档页这类纯静态内容。
- 仓库名必须是
username.github.io(username换成你的 GitHub 用户名) - 所有文件得放在主分支(
main或master)的根目录,不能套在子文件夹里 -
index.html必须存在且可读;引用资源全部用相对路径,比如./css/style.css,别写C:/Users/.../style.css - 启用 Pages 功能后,访问
https://username.github.io,不是https://github.com/username/...
Vercel/Netlify 一键拖拽部署的实际限制
它们比 GitHub Pages 更友好,但“拖拽上传”只适用于极简项目(单个 index.html 带内联 CSS/JS)。一旦你拆出独立的 .css 或 .js 文件,就必须保证目录结构一致,否则 404。
- 上传 ZIP 包时,
index.html必须在压缩包顶层,不是嵌套在dist/或build/里 - 如果用了图片,路径写成
./images/logo.png,而不是images/logo.png(少一个.就可能 404) - Netlify 默认识别
index.html为首页,Vercel 需要在项目根目录加vercel.json指定:{"rewrites": [{"source": "/(.*)", "destination": "/index.html"}]}才能支持 SPA 路由
用云存储(OSS/COS)发布时最容易忽略的权限设置
阿里云 OSS、腾讯云 COS 这类对象存储不是“上传即访问”,默认所有文件都是私有。哪怕你开了“静态网站托管”,如果没手动设成“公共读”,用户访问会直接返回 403 Forbidden。
立即学习“前端免费学习笔记(深入)”;
- 上传后,逐个选中
index.html、style.css、script.js等文件,在控制台点“设为公共读” - 或批量操作:进入 Bucket → 权限管理 → 公共读写(仅测试用)或更安全的“匿名用户读”策略
- 静态网站托管配置里,“默认首页”填
index.html,“默认 404 页面”建议也填404.html,否则刷新子路由会报错 - 生成的访问域名形如
http://bucket-name.oss-cn-hangzhou.aliyuncs.com,注意是http开头——要 HTTPS 得额外绑定自定义域名并申请证书
路径大小写、斜杠方向、相对/绝对路径混用,这三类问题占线上 404 的绝大多数。部署前用浏览器开发者工具的 Network 标签页看哪些资源标红了,比反复猜更直接。



















