ExtDiff 使用指南：3 步让 Word 自动对比两份文档

ExtDiff 使用指南3 步让 Word 自动对比两份文档【免费下载链接】ExtDiffCompare documents using MS Word from the command line.项目地址: https://gitcode.com/gh_mirrors/ex/ExtDiff你有没有经历过这种崩溃瞬间同事发来一份改好了的 Word 文档你打开后对着两个版本逐页翻找眼睛都快看花了才勉强找到几处改动又或者你习惯用git diff追代码变更但仓库里混进了.docx文件一 diff 全是乱码和 XML 标签ExtDiff就是为解决这个问题而生的它是一个极小的命令行工具通过 COM 自动化调用 Microsoft Word 自带的比较文档功能一条命令就能让 Word 自动打开两份文档的对比结果改动之处以修订标记清晰呈现。更妙的是你还可以把它接入 Git让git diff直接读懂 Word 文件。下面这份实战指南带你 3 步上手。为什么你需要一个文档版 diffWord 的审阅 → 比较功能本身很好用但它藏在菜单深处你得先打开文档 → 点审阅 → 点比较 → 弹窗里选文件 → 点确定整整五步操作。如果一个月要比十几次文档这套流程足以让人烦躁。而 .docx 本质上是压缩包里的 XML用文本 diff 工具看它无异于读天书。ExtDiff 的定位就是文档界的 diff 工具把 Word 原生的对比能力变成一条命令、一个按钮甚至一种 Git 工作流让对比文档这件事从手动劳动变成自动执行。快速上手指南3 步跑起来 先确认你的环境满足这三个条件缺一不可Windows 系统脚本基于 PowerShell 和 COM 自动化已安装 Microsoft WordWPS 不兼容必须是 MS Office 的 WordPowerShell 可用Win10 / Win11 自带然后按下面的步骤操作第 1 步获取项目代码打开 PowerShell执行克隆命令git clone https://gitcode.com/gh_mirrors/ex/ExtDiff第 2 步运行对比命令进入项目目录把两个文档路径传给diff-word.cmd第一个是旧版第二个是新版cd ExtDiff diff-word.cmd old.docx new.docx第 3 步查看对比结果此时 Word 会自动启动并打开一个名为 Comparison 的新文档——增删改的内容全部以修订标记显示旧版窗口随后自动关闭只保留对比结果。就这样3 步完成一次文档对比。如果你不想敲命令双击start-gui.cmd还能打开一个图形窗口效果见下图。核心功能逐个击破命令行对比一条命令出结果命令行入口是[Diff-Word.ps1](https://link.gitcode.com/i/046eebc229e573bee16117792a74cea5)diff-word.cmd只是它的批处理代理。核心逻辑其实只有几行关键点在注释里$document $word.Documents.Open($BaseFileName, $false, $false) # 打开旧版文档不显示、不弹窗 $document.Compare($ChangedFileName, [ref]Comparison, ...) # 调用 Word 内置的 Compare 功能 $document.Close([ref]$wdDoNotSaveChanges) # 关闭旧版窗口只留下对比结果脚本还替你处理了两个隐藏坑一是先解析文件路径所以~这类 PowerShell 路径也能用二是自动去掉旧版文件的只读属性否则 Word 会拒绝比较只读文件。图形界面把文件拖进对比框 ️双击start-gui.cmd即可打开图形界面它调用的脚本是[Gui-Diff-Word.ps1](https://link.gitcode.com/i/9832fccc664cff0174178505df1c8925)。上图是 1.3.0 新增的界面注意窗口默认置顶显示方便你从资源管理器拖文件进来。界面设计很贴心窗口始终浮在所有窗口之上TopMost你只需把旧版文档拖到第一个输入框、新版拖到第二个然后点击Compare按钮Word 就会照常弹出对比结果点击Clear清空输入窗口会恢复置顶状态。整个过程鼠标都不用离开比命令行更直观。接入 Git让 git diff 看懂 docx这是 ExtDiff 最亮眼的功能。普通 Git 无法对二进制 docx 做有意义的 diff但配置后git diff会直接调用 Word 帮你对比。在仓库根目录新建或编辑.gitattributes加入一行*.docx diffword再编辑家目录下的.gitconfig注册一个自定义 diff 工具[diff word] command pathToExtDiffFolder/diff-word-wrapper.cmd把pathToExtDiffFolder替换成本地项目路径。这里的桥梁是[diff-word-wrapper.cmd](https://link.gitcode.com/i/34cc8c1915ca4c27bf4a1e02e46e7e2a)它把 Git 传入的两个文件参数%2旧版本、%5新版本转发给diff-word.cmd。如果你想全局生效可以创建一个全局.gitattributes再用git config --global core.attributesfile ~/.gitattributes指向它。实战小案例给文档仓库配上 Word 对比把前面所有功能串起来我们做一个小实验让一个纯文档仓库具备看得见的版本对比。第 1 步初始化仓库并配置git init doc-repo cd doc-repo git config --global core.attributesfile ~/.gitattributes # 指定全局属性文件在家目录的.gitattributes写入*.docx diffword在.gitconfig的[diff word]小节中填好 wrapper 的绝对路径。第 2 步生成两个版本的文档用 Word 新建report.docx写上一段话保存后提交git add report.docx git commit -m v1 初稿接着修改文档增删几行文字保存但不要提交。第 3 步执行对比并观察结果git diff report.docx预期效果Word 被自动唤醒打开一份带修订标记的对比文档——新增内容以下划线显示、删除内容以删除线显示旁边还有批注栏标注修改来源。你甚至不需要git diff支持二进制格式就能像看代码 diff 一样审查文档改动。配合git log回溯历史版本整个文档仓库的演进史都一目了然。常见问题与避坑Q1运行时报错找不到类型 [Word.Application]怎么办说明系统里没有可用的 Microsoft Word COM 对象。检查是否安装了 MS Office 的 WordWPS 不提供该 COM 接口并确认它是 2007 以上版本。Q2提示文档被占用或无法打开文件脚本已自动处理只读属性但如果文档正被另一个 Word 窗口打开还是会冲突。对比前先关掉相关的 Word 窗口即可。Q3配置好 Git 集成后git diff没反应先确认.gitattributes生效执行git check-attr diff -- report.docx应输出word再确认.gitconfig里的路径写对了最后注意git diff只对比已跟踪但未提交的改动文件第一次加入暂存区staged时需要用git diff --cached才能看到。Q4PowerShell 提示禁止运行脚本这是执行策略限制。用powershell -ExecutionPolicy Bypass -File Diff-Word.ps1 old.docx new.docx即可绕过或通过diff-word.cmd间接调用。Q5GUI 窗口点了 Compare 后不再置顶了这是设计行为对比期间让出置顶避免遮挡 Word 的对比结果。点一下Clear按钮窗口就会恢复置顶。总结与下一步一句话概括ExtDiff 用一条命令、一个界面和一套 Git 集成把 Word 原生的文档对比能力带进了命令行工作流从此 diff 不再只是代码的专利。现在就下载试试用它对比你手头最早的一版文档和最晚的一版感受一下3 步出结果的爽快如果你在项目里发现了更好用的配置方案欢迎提交反馈让这个工具惠及更多人。想深入了解实现细节可以翻看项目的变更记录 CHANGELOG.md 了解版本演进或阅读 License.md 确认使用许可。祝你从此告别逐页翻找的文档对比时光【免费下载链接】ExtDiffCompare documents using MS Word from the command line.项目地址: https://gitcode.com/gh_mirrors/ex/ExtDiff创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考