双击打不开HTML文件主因是未关联浏览器，需在系统设置中指定Chrome等浏览器为默认程序；file://协议下AJAX会因安全策略失败，应使用本地服务器如python -m http.server；中文乱码需统一HTML声明与文件保存编码为UTF-8无BOM；移动端需正确设置viewport且避免file://限制。

双击打不开 .html 文件？先看默认打开程序

Windows 或 macOS 上双击没反应，大概率是系统没把 .html 关联到浏览器。不是文件坏了，也不是编码问题。

• Windows：右键 index.html →「属性」→「打开方式」→ 点「更改」→ 选 Chrome、Edge 或 Safari（macOS）
• macOS：右键 →「显示简介」→「打开方式」选浏览器 → 点「全部更改」
• 别用记事本或 VS Code 双击直接开——它们会渲染成纯文本，看不到页面效果

file:// 协议下 AJAX / fetch 失败怎么办

本地双击打开的 HTML，地址栏是 file:///xxx/index.html，这时浏览器会禁用跨源请求（哪怕只是读本地 JSON），报错 net::ERR_FAILED 或 CORS error。

• 开发阶段别双击——用 python3 -m http.server 8000 起个本地服务，然后访问 http://localhost:8000/index.html
• VS Code 用户可装插件 Live Server，右键点「Open with Live Server」
• Chrome 启动时加参数 --disable-web-security --user-data-dir=/tmp/chrome-dev（仅临时调试，不推荐日常用）

中文乱码？检查 <meta charset> 和保存编码

浏览器显示方块字或问号，90% 是编码没对齐：HTML 声明的编码和文件实际保存的编码不一致。

DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur

下载

• 确保 HTML 文件开头有：<meta charset="UTF-8">（注意是 UTF-8，不是 utf8 或 GBK）
• 用编辑器（如 VS Code）确认文件保存编码：右下角点「UTF-8」→「Save with Encoding」→ 选 UTF-8
• 别用 Windows 记事本另存为「UTF-8」——它会偷偷加 BOM，导致某些 JS 报错；改用「UTF-8 without BOM」或换编辑器

移动端打不开？留意路径写法和 viewport

在手机上用文件管理器点开 .html，常出现空白页或样式错乱，和桌面端表现不一致。

立即学习“前端免费学习笔记（深入）”；

• 避免相对路径写成 ./css/style.css，改用 css/style.css（省略 ./ 更稳妥）
• 必须加 viewport meta：<meta name="viewport" content="width=device-width, initial-scale=1.0">
• 手机浏览器对 file:// 支持更严格，JS 模块、import、localStorage 都可能被禁用——真要测试响应式，还是走本地服务器

有些细节看着小，比如 BOM、file:// 下的 fetch、viewport 缺失，但它们会在你最不想出问题的时候一起冒出来。