论文返修时需用latexpand拉平多文件结构，再通过latexdiff的--exclude-textcmd或patch @sect宏实现结构调整精准比对，最后编译验证章节移动、增删及交叉引用是否正确。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
论文返修时需要向编辑说明结构调整情况，比如删掉了“实验方法B”小节、把“结果分析”拆成两章、新增了附录C，但LaTeX源文件里没有目录树视图，光看.tex文本根本看不出章节层级是否被移动或合并。
确认两个版本的主文件结构一致性
先确保old.tex和new.tex都使用相同的文档类（如documentclass{elsarticle}）和核心宏包（如usepackage{amsmath}, usepackage{graphicx}）。如果new.tex新增了usepackage{subfiles}而old.tex没有，latexdiff可能误判整个子文件引入为“新增内容”，而非结构重排。
打开两个文件，检查egin{document}之前的部分，重点比对 ableofcontents、section、subsection等命令的嵌套层级是否匹配。不匹配会导致latexdiff将结构调整识别为大段删除+大段新增，失去对比意义。
用latexpand预处理多文件项目
如果你的项目由main.tex → input{sec/intro.tex} → input{data/table1.tex}多层嵌套组成，直接运行latexdiff会漏掉子文件内的结构调整。必须先合并。
执行：latexpand --include-graphics --max-include-depth=3 main.tex > flat_main.tex
这一步把所有input和include命令展开成单个文件，【注意：--max-include-depth=3必须设够，否则深层引用的.tex不会被拉平】。对修改稿同样操作，得到flat_revision.tex。
生成带结构标记的差异文件
方法一：基础对比（适用于仅调整章节顺序、增删section）
在终端中运行：latexdiff --flatten --exclude-textcmd="section,subsection,subsubsection" flat_main.tex flat_revision.tex > diff_struct.tex
其中--exclude-textcmd参数强制latexdiff跳过对章节命令本身的文本内容比较，只关注这些命令是否存在、是否被移动——这样能避免因标题文字微调（如“Results”→“Experimental Results”）触发整节标红。
方法二：启用结构感知模式（推荐用于大幅重组）
运行：latexdiff --flatten --config='PREAMBLE_ADD="usepackage{etoolbox}makeatletterpatchcmd{@sect}{@tempskipa}{DIFaddbegin@tempskipaDIFaddend}{}{}" --enable-all' flat_main.tex flat_revision.tex > diff_struct.tex
这条命令通过patch LaTeX内核的@sect宏，在每个章节命令入口插入DIFaddbegin/DIFaddend标记，让编译后的PDF在章节标题旁显示“MOVED”或“INSERTED”浮动标签，直观定位结构调整点。
编译差异文件并验证结构高亮
第一步：用xelatex编译diff_struct.tex，确认无报错。若报错“Undefined control sequence DIFaddbegin”，说明缺少宏包，在diff_struct.tex导言区手动添加：usepackage{color}usepackage{ulem}。
第二步：打开生成的diff_struct.pdf，快速翻阅目录页和各级标题。被移动的章节会在标题右侧出现浅灰色小字标注，例如：[MOVED from line 87]；被整体删除的节则整块显示删除线并保留原位置空白；新增节左侧有绿色竖条+“NEW SECTION”水印。
第三步：重点检查交叉引用是否断裂。如果 ef{sec:discussion}在new.tex中指向新位置，但diff_struct.pdf里该引用仍显示“??”，说明latexdiff未正确解析label- ef关联，需在diff_struct.tex中搜索DIFdel{\label{sec:discussion}}，手动将其替换为label{sec:discussion}并重新编译。
