docx-diff-viewer

在 VS Code 中直接预览 DOCX，浏览文件的版本记录，并像查看代码变化一样比较两个 Word 文档版本。

docx-diff-viewer 是一个只读、Git 原生的 DOCX 查看与差异扩展。它不会编辑文档，也不要求切换整个仓库版本；文档解析和比较均在本地完成。

功能

• 直接预览 DOCX：点击 .docx 文件即可查看文本、标题、列表、表格、图片和基础排版。
• 查看版本记录：按文件浏览历史版本，无需切换整个仓库版本。
• 可视化版本对比：以左右双栏展示较早版本和较新版本，并高亮新增、删除和修改内容。
• 融入源代码管理：从 VS Code 源代码管理面板打开 DOCX 修改时，直接查看上次记录版本与当前文件的差异。
• 快速定位变化：支持上一处、下一处变化以及左右同步滚动。
• 版本详情：悬浮版本标题可查看版本说明、创建者、记录时间和版本标识。

使用方式

预览当前文件

在资源管理器中打开任意 .docx 文件，扩展会使用只读查看器显示文档内容。

查看本次修改

在 DOCX 查看器顶部选择“本次修改”，或者在 VS Code 源代码管理面板中点击已修改的 DOCX 文件。

左侧显示上次记录的版本，右侧显示当前文件或准备提交的版本。

浏览和比较历史版本

1. 选择“版本记录”查看该文件保存过的版本。
2. 选择任意版本直接预览。
3. 使用“选择版本对比...”比较两个历史版本，或比较历史版本与当前文件。

版本含义

隐私

DOCX 渲染、版本读取和文档比较均在本地完成。扩展不上传文档，不包含遥测，也不会执行 Git commit、push 或修改 DOCX 文件。

支持范围

• VS Code 1.96.0 或更高版本。
• 预览支持普通 .docx 文件。
• 版本记录和比较功能需要文件位于当前打开的 Git 仓库中。
• Git LFS 文档需要对应历史对象已存在于本地。

当前限制

• 不支持编辑或保存 DOCX。
• 不支持旧版 .doc 格式。
• 不保证完全复刻 Microsoft Word 的页面布局。
• 主要比较文本和文档结构，不提供完整的格式属性差异报告。
• 文本框、SmartArt、复杂浮动布局等高级内容可能无法完整呈现。

与普通 DOCX 查看器的区别

普通查看器解决“能否打开 DOCX”；docx-diff-viewer 重点解决“这个文档在两个版本之间具体发生了什么变化”。它面向需要在 Git 仓库中维护合同、方案、规范和其他 Word 文档的团队。

问题反馈

请通过 GitHub Issues 提交问题。请勿公开上传包含合同、客户信息或其他敏感内容的文档。

许可证

MIT