双击html文件打不开是因浏览器安全限制file://协议，非转换失败；应使用http.server或live server等本地服务解决，注意路径、权限及缓存问题。
直接双击 .html 文件就能打开网页，但浏览器可能报错“无法加载本地文件”
这不是转换失败，而是现代浏览器出于安全限制，默认禁止从 file:// 协议加载某些资源（比如 fetch、XMLHttpRequest、本地 jsON 文件、import 模块）。你写的 HTML 本身没问题，只是运行环境卡住了。
- 最简单的验证方式：右键
index.html→ “用浏览器打开”，如果页面结构、文字、图片正常显示，说明它已经是合法网页 - 如果空白、控制台报
net::ERR_FILE_NOT_FOUND或Cross-Origin Read Blocking，大概率是 JS 尝试读取了同目录下的data.json或用了import，而浏览器没放行 - 开发阶段别依赖双击——用
python3 -m http.server 8000（Python）或npx serve（Node）起个本地服务，访问http://localhost:8000就一切正常
vscode 里点“Live Server”按钮没反应？检查这三件事
VS Code 的 Live Server 插件本质是启动一个本地 HTTP 服务，不是魔法。常见静默失败是因为路径或权限问题。
- 确保你当前打开的是文件夹（不是单个
.html文件）：菜单栏 → “文件” → “打开文件夹”，选中含index.html的整个目录 - 确认插件已启用且没被禁用：Ctrl+Shift+P → 输入
Live Server: Open with Live Server，手动触发一次 - windows 用户注意杀毒软件/防火墙：有些会拦截
127.0.0.1:5500端口，换端口试试（右键 HTML 文件 → “Open with Live Server” → 选 “Change Live Server port”）
用命令行快速起服务：Python 和 Node 哪个更稳？
Python 内置模块最轻量，Node 生态兼容性更好——取决于你项目里有没有 node_modules 或需要 ES modules 支持。
- 纯静态页（只有 HTML/CSS/JS）：优先用
python3 -m http.server 8000，无需安装，端口占用少，Win/mac/linux 全支持 - 用了
import语法或要跑Vite/webpack开发服务器：必须用 Node，装完后执行npx serve -s（-s表示单页应用模式，避免路由 404） - 别用
python2 -m SimpleHTTPServer：Python 2 已淘汰，不支持 UTF-8 路径和现代 MIME 类型，中文文件名会 404
为什么改了 HTML 刷新没变化？缓存比你想的更顽固
浏览器缓存分好几层：内存缓存、磁盘缓存、Service Worker、甚至 CDN 缓存（如果你推到了 github Pages）。改完不生效，90% 是缓存没清干净。
立即学习“前端免费学习笔记（深入）”；
- 开发时强制刷新：Mac 按
Cmd+Shift+R，Windows 按Ctrl+F5，绕过内存缓存直接重拉 - chrome DevTools 里勾选
Disable cache（Network 面板左上角），这个选项只在开发者工具打开时生效 - 如果用了
service-worker.js，改完 HTML 后要手动 unregister：Application → Service Workers → 点 “Unregister”，否则旧版本一直接管请求
文件路径写错、协议限制、缓存机制——这些不是“HTML 变不成网页”，而是网页在真实环境中运行时绕不开的几道窄门。跨过去不难，但得知道门在哪。