写论文或维护宏包时,源码缩进、公式空格和表格对齐常常要花时间手工整理。多人协作中,统一源码风格也能让 diff 更容易阅读。我最近在做一个命令行工具 tift,用于整理 LaTeX 和 BibTeX 源码,欢迎大家试用和反馈。
tift 使用 Rust 编写,可在 Windows、Linux 和 macOS 上运行。它能整理环境与列表缩进、数学公式空格、表格和公式列对齐,也支持 BibTeX / BibLaTeX、常见宏包语法、CJK 文档及 TikZ、expl3 等源码。默认保留段落原有换行,BibTeX 条目及字段顺序也按源码保留;需要重排长段落、排序或清理文献数据时,可以按项目配置启用相应选项。
例如,下面的输入会补齐数学空格,并按列对齐表格:
\begin{itemize}
\item Measurement: $E=mc^2$.
Its explanation continues here.
\item Reference value.
\end{itemize}
\begin{tabular}{ll}
Label&Value\\Longer label&42\\
\end{tabular}
\begin{itemize}
\item Measurement: $E = mc^2$.
Its explanation continues here.
\item Reference value.
\end{itemize}
\begin{tabular}{ll}
Label & Value \\
Longer label & 42 \\
\end{tabular}
日常使用可以先预览差异,再决定是否写回文件:
tift --diff main.tex
tift main.tex
tift .
在 CI 中可用 tift --check . 检查项目格式。通过 tift --dump-config > tift.toml 生成配置起点,可以设置缩进宽度、换行规则、对齐方式及 BibTeX 选项。VS Code、Neovim、pre-commit 等集成方式见项目指南。
最新版本为 0.1.6。可以从 GitHub Releases 下载 Windows、Linux 或 macOS 的预编译程序,也可以使用 Cargo 安装(需要 Rust 1.99.1 或更新版本):
cargo install tift --version 0.1.6 --locked --registry crates-io
项目采用 MIT 许可证。欢迎试用、提 issue,也欢迎分享不同模板和宏包下的格式化结果。