tift|用于论文、讲义和模板的 LaTeX 源码格式化工具

发布于 2026-11-22 21:50:17

tift 是一款用 Rust 编写的开源格式化工具,支持 LaTeX 源文件和 BibTeX、BibLaTeX 文献库。它在本地运行,采用 MIT 许可证,并提供 Windows、macOS 和 Linux 的预编译版本。项目主页

格式化效果

在 LaTeX 源码中,tift 会为环境和列表添加缩进,整理数学表达式的空格,并对齐公式与表格中的 &。图 1 展示了 align 和 tabular 的处理结果。原先写在同一行源码中的两条表格记录被拆开,各列的位置也更容易辨认。

tift-latex-before-after.png

图 1 LaTeX 公式与表格格式化前后对照

对于 .bib 文件,tift 默认统一字段缩进并对齐等号,同时保留条目和字段的原有顺序。合并来自不同来源的文献记录后,可以先统一格式,再逐条核对作者、年份和出版信息。条目排序可按项目需要单独启用。BibTeX 与 BibLaTeX 配置

tift-bibtex-before-after.png

图 2 BibTeX 条目格式化前后对照

两张图均使用 tift 0.1.6 的默认配置生成。

安装与试用

从 GitHub 下载对应平台的预编译包,解压后将可执行文件所在目录加入 PATH。下载 tift

tift --diff main.tex  # 预览差异,不写入文件
tift main.tex         # 格式化并写回 LaTeX 源文件
tift references.bib   # 格式化参考文献库
tift --check .        # 检查当前项目是否符合格式

默认配置使用四个空格缩进,并保留正文已有的换行。项目可通过 tift.toml 统一缩进与折行规则。日常编辑可配合 VS Code 的 LaTeX Workshop 启用保存时格式化,协作项目也可在 CI 中运行 tift --check . 检查提交。配置指南 · 编辑器集成

欢迎在评论区分享学位论文模板、复杂表格或自定义宏环境的使用体验。如遇到格式化异常,反馈时可附上最小可复现源码、tift 版本和预期输出。提交问题

0 条评论

发布
问题