index.html是纯静态HTML文件，由浏览器直接解析，不依赖服务端环境；index.aspx是ASP.NET动态页面，需IIS等服务器编译执行后才生成HTML返回。
index.html 是静态 HTML 文件，直接由浏览器解析；index.aspx 是 ASP.NET 动态页面，必须经服务器编译执行后才生成 HTML 返回给浏览器。
index.html 本质是纯前端资源
它不依赖任何服务端运行环境，丢到任意 HTTP 服务器（比如 Nginx、Apache、甚至本地 file:// 协议）都能直接打开。内容完全固定，每次访问看到的都一样，除非你手动改文件。
- 没有服务端逻辑：不能读数据库、不能调用 C# 方法、不能根据用户身份动态渲染
- 路径无关性：只要 URL 能定位到这个文件，服务器就原样返回，不走任何中间件或路由
- 性能开销极低：无解析、无编译、无会话管理，CDN 缓存友好
index.aspx 必须由 IIS 或支持 ASP.NET 的服务器处理
它不是最终发给浏览器的内容，而是一个“模板 + 代码”的混合体，需要 .NET 运行时参与生命周期（Page_Init、Page_Load、Render 等）。浏览器收到的永远是它输出的 HTML，而不是 .aspx 源码本身。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
- 后端代码可嵌入：
块、表达式、runat="server"控件都需服务端执行 - 依赖配置：IIS 必须注册 ASP.NET 模块，
web.config中的 - 调试信息敏感：若配置不当（如
customErrors="Off"），错误堆栈可能暴露服务器路径或类名
两者混用时常见故障点
当项目同时存在 index.html 和 index.aspx，且服务器默认文档顺序没调好，结果往往出人意料：
- IIS 默认文档列表通常是
index.html、index.htm、default.asp、index.aspx……靠前的会优先命中，index.aspx可能根本不会被访问到 - 如果把
index.aspx改名为index.html直接扔进目录——浏览器会把它当纯文本显示源码，因为服务器没触发 ASP.NET 解析管道 - 前端路由（如 React Router 的
BrowserRouter）部署在 IIS 时，若未配置web.config回退规则，刷新子路径（如/user/123）会 404，因为 IIS 在找物理存在的index.html，而非交由前端 JS 处理
真正容易被忽略的是：**静态文件和动态页面的部署路径权限经常不同**。比如 index.aspx 所在目录若没开启“脚本执行”权限，IIS 会直接 500 错误，而 index.html 在同一目录下却完全正常——这种差异不是代码问题，是服务器角色配置层面的断层。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
