HTML文件需以.html为后缀，用浏览器直接打开或通过本地服务器运行，检查控制台错误确保代码正确解析。
如果您编写了 HTML 代码，但页面无法正常显示，则可能是由于缺少基础运行环境或执行方式不正确。以下是让 HTML 文件在本地或浏览器中正确运行的基本条件与具体操作步骤：
一、确保文件保存为 .html 或 .htm 后缀
HTML 文件必须以标准网页后缀命名，否则浏览器无法识别其类型并解析渲染。系统需将文本内容明确标识为超文本标记语言文档。
1、使用记事本、VS Code、Sublime Text 等纯文本编辑器编写 HTML 代码。
2、点击“文件”→“另存为”，在“文件名”栏输入 index.html 或 page.htm。
立即学习“前端免费学习笔记（深入）”；
3、在“保存类型”下拉菜单中选择 所有文件（避免自动添加 .txt 后缀）。
4、确认文件图标显示为浏览器图标（如 Chrome、Edge 图标），而非文本文档图标。
二、使用双击方式在默认浏览器中打开
本地 HTML 文件可通过操作系统直接调用关联浏览器打开，无需网络或服务器支持，适用于静态页面快速预览。
1、在文件资源管理器中找到已保存的 .html 文件。
2、双击该文件，系统将使用默认浏览器加载并渲染页面。
3、若页面空白或显示源码，请右键文件→“属性”→检查“打开方式”是否为浏览器程序。
三、通过浏览器菜单手动打开文件
当双击未响应或默认程序错误时，可主动在浏览器中选择文件路径加载，绕过系统关联设置限制。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
1、启动 Chrome、Firefox 或 Edge 浏览器。
2、点击右上角三个点（Chrome/Edge）或三条横线（Firefox）→选择 文件 → 打开文件。
3、在弹出窗口中定位并选中您的 .html 文件，点击“打开”。
四、使用本地服务器运行（适用于含 AJAX、Fetch 或模块化 JS 的页面）
现代前端功能（如 fetch() 请求本地 JSON、ES6 模块导入）受浏览器同源策略限制，无法通过 file:// 协议直接执行，需启用 HTTP 服务。
1、在 HTML 文件所在文件夹内，按住 Shift 键右键，选择 在此处打开 PowerShell 窗口（Windows）或 在终端中打开（macOS/Linux）。
2、输入命令：python3 -m http.server 8000（Python 3 用户）或 python -m SimpleHTTPServer 8000（Python 2 用户）。
3、打开浏览器，访问 http://localhost:8000，点击对应 HTML 文件即可运行。
五、检查浏览器控制台报错信息
页面未按预期显示时，浏览器开发者工具可暴露语法错误、路径错误或资源加载失败等关键线索，是定位问题的第一现场。
1、在已打开的 HTML 页面中，按下 F12 或 Ctrl+Shift+I（Windows/Linux）或 Cmd+Option+I（macOS）。
2、切换到 Console 标签页，查看红色错误提示文字。
3、根据提示内容检查：标签是否闭合、引号是否匹配、JS 文件路径是否拼写错误、CSS 是否被阻塞等。
