HTML无法控制“另存为”文件名，仅JavaScript触发的Blob/data URL下载可指定；a标签download属性限同源，跨域失效；中文名需服务端Content-Disposition头或前端Blob编码处理。
HTML 中无法直接控制下载文件名
浏览器下载 HTML 页面本身（比如用户右键“另存为”）时，文件名完全由用户决定，HTML 标签或属性无法干预。这不是限制，而是安全机制——网页不能擅自指定本地保存路径或名称。
真正能控制导出文件名的场景，只发生在「通过 JavaScript 触发下载」时，且仅限于 blob 或 data URL 方式生成的下载请求。常见于导出表格、生成报告、下载前端渲染结果等。
a 标签 download 属性只对同源 URL 有效
<a download="report.html"></a> 看起来能命名，但实际有严格限制：如果链接目标是跨域资源（比如指向 https://api.example.com/data.json），浏览器会忽略 download 属性，直接跳转或另存为原始 URL 名（如 data.json）。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 同源静态文件可用：
<a href="/assets/template.html" download="模板_2024.html">下载模板</a> - 跨域或动态内容必须走 JS：先
fetch拿到内容，再用Blob+URL.createObjectURL创建本地 URL -
download值不要含路径（如"./export/xxx.html"），否则部分浏览器会降级为无命名
JS 下载时 filename 编码容易导致中文乱码
用 URL.createObjectURL 配合 <a download></a> 下载时，如果 download 属性值含中文（如 "导出_订单.html"），Safari 和旧版 Edge 可能显示为乱码或截断。这不是 HTML 问题，而是浏览器对 download 属性的编码处理不一致。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
解决办法不是改 HTML，而是绕过它：
- 用
new Blob([content], {type: "text/html;charset=utf-8"})显式声明编码 - 创建
<a></a>后，用click()触发，而非依赖用户点击 - 兼容性兜底：对 Safari，可尝试用
encodeURIComponent处理文件名（但注意download属性本身不支持解码，所以更稳的方式是服务端生成或改用 iframe +document.execCommand("SaveAs")—— 仅 IE）
示例关键片段：
const blob = new Blob([htmlString], { type: "text/html;charset=utf-8" });
const url = URL.createObjectURL(blob);
const a = document.createElement("a");
a.href = url;
a.download = "订单汇总.html"; // Chrome/Firefox 正常；Safari 建议改用英文前缀+时间戳
a.click();
URL.revokeObjectURL(url);
服务端响应头比 HTML 更可靠
如果导出逻辑最终走 HTTP 请求（比如点击后请求 /api/export?format=html），那文件名应由服务端通过 Content-Disposition 响应头控制，例如：
Content-Disposition: attachment; filename="report.html" Content-Disposition: attachment; filename*=UTF-8''%E8%AE%A2%E5%8D%95_%E6%80%BB%E6%8B%AC.html
此时 HTML 页面里怎么写 <a></a> 都不重要，浏览器以响应头为准。这也是为什么 CMS 或后台系统导出功能几乎都走后端。
前端能做的只有两点：确保请求 URL 携带必要参数（如 filename_hint）、避免在 JS 里拼接不可信的文件名（防 XSS）。
复杂点在于：不同浏览器对 filename* 的支持程度不同，而手动构造 RFC 5987 编码容易出错。真要兼顾中文名，优先让后端处理，前端只传原始语义参数（如 name=订单汇总&date=20240615）。
