双击打开HTML文件会报错,因file://协议下fetch、AJAX、localStorage等均被浏览器禁止;必须使用本地HTTP服务(如Live Server或http-server)才能正常运行。

直接用浏览器打开 index.html 文件能看基本效果,但遇到 AJAX、fetch、本地 localStorage 权限或跨域资源加载失败时,一定会报错——因为浏览器默认禁止 file:// 协议下执行这些操作。必须起一个本地 HTTP 服务。
为什么双击打开 HTML 总是报错:Failed to load resource
这是最常被忽略的起点问题。浏览器地址栏显示 file:///Users/xxx/index.html 时,所有涉及网络请求的 API(比如 fetch('./data.json')、import('./module.js'))都会被拦截,并在控制台抛出类似 net::ERR_FAILED 或 CORS policy: No 'Access-Control-Allow-Origin' header 的错误。
- 不是代码写错了,是协议限制了能力
-
file://下连相对路径的 JS/CSS 加载都可能失败(尤其含空格或中文路径) - Chrome 从 2023 年起对
file://的localStorage和indexedDB也做了降级处理
VS Code + Live Server 插件是最省事的调试入口
它一键启动 http://127.0.0.1:5500/,自动刷新,且不依赖 Node.js 全局环境配置。
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库,专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考,支持声明式与编程式两种初始化方式,提供 $cm/$m 数据访问方法。
- 安装插件后,右键点击任意
.html文件 → Open with Live Server - 首次运行会弹出权限提示,点“允许”即可(macOS 可能需在系统设置里授权终端访问网络)
- 修改保存后,页面自动刷新;如果没反应,检查右下角状态栏是否显示
Live Server: Running - 注意:它默认只 serve 当前打开的文件所在文件夹,子目录里的资源要确保路径正确,比如
./css/style.css而不是../css/style.css
命令行起 http-server 更适合多文件协作或 CI 场景
当你需要共享给同事预览、或集成进构建脚本时,http-server 更可控,且端口、缓存、CORS 都可配。
- 先确认已安装 Node.js:
node -v和npm -v应返回版本号(≥14.0.0) - 全局安装:
npm install -g http-server - 进项目根目录后运行:
http-server -p 8080 -c-1(-c-1禁用缓存,避免调试时看到旧资源) - 若需支持跨域请求(比如调本地 mock API),加参数:
--cors - 注意:它不会自动监听文件变化,改完 HTML 后仍需手动刷新浏览器
真正容易被卡住的,往往不是选哪个工具,而是没意识到「浏览器地址栏 URL 协议」决定了你能用哪些 Web API。只要看到控制台报资源加载失败,第一反应该看地址栏是不是还停在 file:// ——而不是翻来覆去改 src 路径或重写 fetch 逻辑。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










