必须先执行查询，否则HTML导出为空；Navicat不自动运行SQL，仅转换已加载结果集为表格，需确认状态栏显示“X rows returned”且导出源为已执行的查询而非表。
导出前必须先执行查询，否则HTML里只有表头
navicat 的 html 导出不自动运行 sql，它只把当前已加载的结果集转成 <table>。如果你在查询编辑器里写了 select * from users where status = 'active'，但没按 f9 或点击运行按钮，导出的 html 文件打开后就是空表格或仅有列名。
常见错误现象：导出向导一路点“下一步”，生成的 HTML 在浏览器里打开，<tbody> 为空，<thead> 却有字段名。
- 确认状态栏显示类似 “127 rows returned” 而非 “0 rows”
- 右键查询结果区域 → “导出向导”，不要从左侧表节点右键（那是导全表，不走当前 SQL）
- 导出向导第一页，“导出记录”下拉菜单必须选
当前查询结果，不能选结构或全部记录
导出向导里选“HTML”后，关键参数要手动调
Navicat 16 默认导出的 HTML 是带内嵌 CSS 和折叠 JS 的交互式报告，适合本地查看，但发邮件或嵌入 Confluence 常出问题——比如 Safari 拒绝执行本地 JS，表格不展开；或者 Outlook 渲染时样式错乱。
实操建议：
- 在导出向导第四步（附加选项）中，取消勾选
Include JavaScript—— 这能避免大部分浏览器兼容性问题 - 勾选
Include CSS styles可保留基础表格边框和对齐，但若需纯语义化 HTML（如对接下游解析），可也取消 - 文件编码务必选
UTF-8，尤其含中文、emoji 或数学符号时；选GBK会导致浏览器显示 - “标题”字段可填业务名称，如
用户活跃度日报，它会写进<h1>标签，而非仅作文件名
导出为空？重点检查 WHERE 条件是否生效于查询源
你写了带 WHERE 的 SQL 并执行成功，但导出 HTML 后发现数据不对（比如该过滤的没过滤、该有的没出现），大概率是导出源类型错了。
立即学习“前端免费学习笔记（深入）”；
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
Navicat 对两种源的处理逻辑完全不同：
- 如果导出源是左侧连接树里的“表”（如
users），导出向导中的WHERE 条件输入框是灰色禁用的，填了也无效 - 只有导出源是“查询”（即你新建的 .sql 文件，或查询编辑器里已执行过的语句），WHERE 才可能被识别——但更稳妥的做法是直接把条件写死在 SQL 里，别依赖导出向导的输入框
- 验证方法：导出前，在查询窗口执行
SELECT @@sql_mode;和SELECT USER(), CURRENT_USER();，确保权限上下文一致，避免视图或 DEFINER 导致实际查不到数据
计划任务里无法直接导出 HTML，得靠命令行 + 脚本链
Navicat 计划任务界面里根本找不到 HTML 导出选项。所谓“定时生成报表”，必须拆成两步：先用 navicatcli（Windows 下是 NavicatCLI.exe）执行查询输出 CSV，再用 Python 脚本读 CSV 调 pandas.DataFrame.to_html() 生成最终 HTML。
容易踩的坑：
-
navicatcli --query不支持直接输出 HTML，只支持csv、tsv、json；路径含空格必须用英文双引号包裹，例如"C:\Program Files\Navicat\navicatcli.exe" - 脚本里用
pandas.read_csv(..., encoding='utf-8')，漏设encoding会导致中文变乱码；to_html(escape=False)才能保留 HTML 标签（如链接、颜色标记） - 计划任务若以系统服务方式运行，
--profile参数必须显式指定 Navicat 连接配置路径，否则找不到已保存的连接
真正难的不是写脚本，而是让整个链条在无人值守时稳定跑通：ncli 是否有权限读取 profile、Python 是否能访问目标路径、导出目录磁盘空间是否足够、HTML 文件名是否带时间戳避免覆盖——这些细节一环断，整条链就静默失败。
