Git Diff Margin 技术文档

1. 安装指南

Git Diff Margin 插件可以通过以下两种方式进行安装：

• Visual Studio 扩展管理器：在 Visual Studio 的扩展管理器中搜索 Git Diff Margin 并安装。
• 扩展库链接：访问 Visual Studio Marketplace 并下载安装。

此外，您还可以使用 Chocolatey 来安装 Git Diff Margin。

2. 项目的使用说明

Git Diff Margin 插件实时显示当前编辑文件在 Visual Studio 边距和滚动条上的 Git 变更。以下是一些主要功能和使用说明：

• 支持 Visual Studio 2012 到 Visual Studio 2022：插件兼容多个版本的 Visual Studio。
• 快速查看当前文件的所有变更：在左侧边距、滚动条地图和栏模式下查看，支持带或不带源代码概览。
  • 蓝色矩形表示修改
  • 绿色矩形表示新行
  • 红色三角形表示删除
  • 所有颜色都可以通过 Visual Studio 字体和颜色选项进行配置
• 撤销变更：支持撤销操作。
• 复制旧代码到剪贴板：将旧代码复制到剪贴板。
• 选择性复制旧代码：在弹出窗口中选中旧代码部分进行复制。
• 在 Visual Studio Diff 窗口中显示差异：查看文件变更的差异。
• 使用自定义键盘快捷键导航到上一个/下一个变更：或使用弹出窗口图标进行导航。
• 通过自定义键盘快捷键打开弹出窗口，按 ESC 键关闭。
• 支持 Visual Studio 2013 的暗色、亮色和蓝色主题。
• 支持缩放功能。
• 与 HEAD 以外的内容进行比较（高级用户）。

为了获得更好的体验，建议禁用 Visual Studio 内置的“跟踪更改”栏。

3. 项目API使用文档

Git Diff Margin 插件主要是为 Visual Studio 开发的，因此它没有对外提供的 API。插件的核心功能是集成到 Visual Studio 中，实时显示和操作 Git 变更。

4. 项目安装方式

以下是通过命令行使用 Git 克隆仓库并进行构建的步骤：

git clone https://github.com/laurentkempe/GitDiffMargin.git
cd GitDiffMargin

使用 Visual Studio 2017 或更高版本打开 GitDiffMargin.sln 解决方案，然后构建并运行。

以上是 Git Diff Margin 的安装指南、使用说明和项目安装方式。如果您在使用过程中有任何问题或建议，可以通过 Visual Studio Marketplace 上的评论、Twitter 或其他途径与开发者联系。