LaTeXdiff实战指南：高效标注论文修改差异

1. 为什么你需要LaTeXdiff？

写论文最头疼的环节之一就是修改版本管理。我见过太多研究生在深夜实验室对着屏幕抓狂："导师到底让我改哪里来着？"更可怕的是，当你把修改稿发给审稿人时，对方可能根本找不到你精心调整的内容。这时候，LaTeXdiff就像个会发光的标记笔，能把所有改动自动标注得明明白白。

这个工具本质上是个智能比对引擎。它用Perl脚本解析两个LaTeX文件，生成的新文件里，新增内容会变成蓝色带下划线，删除内容变成红色带删除线。我指导过的博士生小王就靠这个功能，让三审意见从"修改不清晰"变成了"修改完善"。最妙的是，它不需要你安装整套LaTeX环境，就像用WinRAR解压文件那样简单。

2. 三步完成基础安装

2.1 Windows用户专属通道

如果你用MikTeX，恭喜你找到捷径。打开MikTeX Console（不是TeXworks！），在"Packages"标签页搜索latexdiff，勾选安装时记得把"Install missing packages on the fly"打开。我去年在清华实验室装机时，发现某些版本会漏装Perl依赖，这时需要手动运行：

mpm --install=perl

2.2 Mac用户的终端战场

用Homebrew的读者可以偷着乐了。在Terminal里输入：

brew install latexdiff

但去年帮北大数学系装机器时发现，某些M1芯片机型需要额外配置PATH。如果遇到"command not found"，试试：

export PATH="/opt/homebrew/bin:$PATH"

2.3 Linux玩家的编译指南

Ubuntu用户虽然能直接apt-get，但官方源版本可能较旧。我推荐用cpan安装最新版：

sudo cpan install Algorithm::Diff

记得先装好gcc和make。去年在中科院某所部署时，发现缺少Text::Diff模块会导致报错，这时需要：

sudo cpan install Text::Diff

3. 核心操作手册

3.1 基础命令的隐藏玩法

官方文档里那个简单的latexdiff old.tex new.tex > diff.tex命令，其实藏着三个坑：

1. 文件路径不能有中文（我在浙大实验室踩过这个雷）
2. 两个tex文件编码必须一致（建议全用UTF-8）
3. 不要用绝对路径，否则生成的diff文件可能报错

实测最稳的用法是：

cd /path/to/your/tex latexdiff --encoding=utf8 original.tex revised.tex > changes.tex

3.2 参数组合的实战技巧

不同期刊对修改标注有不同要求。Nature系列喜欢用高亮模式，这时候就该祭出：

latexdiff --type=CFONT original.tex revised.tex > diff.tex

而Springer期刊偏好简洁标注，这个组合我用了三年：

latexdiff --type=TRADITIONAL --config="PICTUREENV=(?:picture|DIFnomarkup)[\w\d*@]*" paper.tex paper_rev.tex

参数PICTUREENV特别重要，它能避免图片被错误标记。去年有个学生因为图表被误标，差点被拒稿。

4. 高级定制方案

4.1 自定义标注样式

在preamble里添加这些代码，能让修改标记变成学术圈最爱的"蓝增红删"样式：

%DIF PREAMBLE \providecommand{\DIFadd}[1]{{\color{blue}\uwave{#1}}} \providecommand{\DIFdel}[1]{{\color{red}\sout{#1}}} \providecommand{\DIFaddbegin}{} \providecommand{\DIFaddend}{} \providecommand{\DIFdelbegin}{} \providecommand{\DIFdelend}{}

如果想搞点创新，比如给删除线加波浪效果，可以这样玩：

\providecommand{\DIFdel}[1]{{\color{red}\sout{\uwave{#1}}}}

4.2 公式比对的黑科技

默认设置对数学公式支持不太好。这是我调试出的最佳配置：

latexdiff --math-markup=3 --disable-citation-markup original.tex revised.tex

参数--math-markup=3会让公式差异显示为紫色边框，而--disable-citation-markup能避免参考文献被误标。去年用这个方法处理了PRL论文的200多处公式修改。

5. 常见报错解决方案

5.1 "Undefined control sequence"错误

这通常是因为缺少ulem或color包。在preamble里强制加载：

\usepackage[normalem]{ulem} \usepackage{xcolor}

如果还报错，试试在命令后加--append-safecmd=xxx参数，把报错的命令名替换xxx。

5.2 图片标注异常问题

遇到图片被错误标记时，用这个命令排除所有图形环境：

latexdiff --exclude-safecmd=includegraphics --exclude-textcmd=includegraphics old.tex new.tex

我在APL投稿时就遇到过图片被红框包围的尴尬情况，后来发现是忘记排除tikzpicture环境。

6. 配套工具链

6.1 latexrevise的三种模式

这个工具相当于论文修改的"撤销/重做"按钮：

• -a模式：接受所有修改（生成干净的新版本）
• -d模式：拒绝所有修改（回退到原版）
• -s模式：简化标记（保留修改痕迹但去掉颜色）

我带的硕士生最喜欢用这个交终稿：

latexrevise -a diff.tex > final.tex

6.2 版本控制集成

用git的同学可以试试latexdiff-vc，它能自动比对历史版本：

latexdiff-vc --git --flatten -r HEAD~2 paper.tex

参数--flatten能处理子文件，-r HEAD~2表示比较当前版本和前两个提交。去年帮计算机系搭建的论文协作系统就基于这个方案。