格式规范三件套：SQL 美化、参考文献引用与 PDF 目录

写文档、写论文、整理交付材料时，最不产生价值但最容易被挑刺的就是格式：SQL 挤成一行没人看得懂、参考文献五种规范来回改、装订好的 PDF 缺一页目录。三个工具分别把这类「规范活」变成填表与粘贴。

一、SQL 格式化：让一行查询变可读

从日志里捞出来的 SQL 常常是一整行，排查执行逻辑全靠眼力。格式化工具做四件事：

关键字大写：SELECT、FROM、WHERE、JOIN 一眼分出结构；
主要子句换行：FROM、WHERE、GROUP BY、ORDER BY 各自起行；
字段与条件缩进：嵌套子查询的层次能直接看出来；
保护字符串字面量：值里含关键字或换行时不会被误改。

它是纯字符串处理，不连接数据库、不执行 SQL，所以贴生产查询也不会有副作用（敏感表名仍建议脱敏）。Code Review 前统一格式化一遍，diff 会干净很多。

二、参考文献：五种规范一次生成

规范	常见使用领域	辨识特征
APA 7	心理学、教育学、社科	作者姓氏 + 年份，重年份
MLA 9	文学、语言学、人文学科	作者 + 页码，重页码
Chicago	历史、人文、部分社科	注释-参考文献或作者-日期两套体系
IEEE	工程、计算机、电子	方括号编号 [1]，按引用顺序排
GB/T 7714	国内高校学报、学位论文	文献类型标识 [J][M][D] 与中文著录规则

填一次作者、题名、期刊、年份、卷期页码，五种格式同时生成，直接复制进论文或导入文献管理软件。要点：先确认学校/期刊要求的是哪一版（APA 7 与旧版、GB/T 7714-2015 与 2005 细节不同）；中文文献在英文规范下的拼音转写、期刊名缩写等，生成后仍需按目标要求复核。

三、PDF 目录页：A4 排版并合并进文档

按「页码标题」逐行录入章节，工具自动生成带点线引导的 A4 中文目录页 PDF，也可以把目录插到原 PDF 前面合并下载，全程不上传文件到服务器。

两个容易忽略的细节：

页码以最终装订版为准：插入目录页会让后面所有页码顺延一页，先定稿正文再生成目录，或者预留目录页位；
标题层级一致：一级标题顶格、二级缩进，同一份目录里别混用多种缩进宽度，点线对齐才好看。

四、常见问题

问：格式化会改变 SQL 的执行结果吗？
不会，只增删空白与调整关键字大小写。唯一需要留意的是某些方言里区分大小写的引号标识符，工具对字符串字面量做了保护，但特殊方言建议格式化后跑一次验证。

问：生成的参考文献能直接交论文吗？
建议当作准确草稿。卷期页码、DOI、多位作者的缩写规则各校要求略有差异，提交前按学校模板核对一遍。

问：PDF 合并会上传我的文档吗？
不会，目录生成与合并都在浏览器本地完成，文件不出本机。

📄 SQL 格式化：关键字大写、子句换行、字段条件缩进，字符串字面量自动保护；参考文献引用格式生成器：填一次信息，一次生成 APA 7 / MLA 9 / Chicago / IEEE / GB/T 7714 五种格式；PDF 目录页生成器：按「页码标题」生成带点线的 A4 中文目录，可插入原 PDF 前合并下载。全部本地处理不上传。排版相关的还可看打印模板与尺寸指南。

五、一条交付前自查清单

代码材料 → SQL 统一格式化，diff 干净、逻辑可读；
论文与报告 → 先锁定目标引用规范，再生成并逐条核对字段；
装订文档 → 正文定稿后生成目录，核对页码顺延与缩进一致；
所有含真实数据的文件 → 本地处理，脱敏后再粘贴。

格式规范的价值是「让别人不用猜」。三个工具都不改内容、只管呈现，正好把这类低价值耗时活收掉。