diff-so-fancy 安装与使用指南

(diff-so-fancy 是一个增强型的 Git 差异比较工具，旨在使你的代码差异对比更加美观易读。)

1. 项目目录结构及介绍

diff-so-fancy 的目录结构包括以下几个关键部分：

• bin: 包含可执行脚本 diff-so-fancy，这是主程序。
• lib: 存放辅助库和脚本，用于支持主要功能。
• zsh: 如果你使用 ZSH shell，这个目录提供了插件集成。
• .github: GitHub 相关的设置和自动化脚本。
• LICENSE: 项目许可证信息。
• README.md: 项目的说明文档。

2. 项目的启动文件介绍

启动文件是位于 bin 目录下的 diff-so-fancy 脚本。这个脚本是当通过命令行调用时执行的主要程序。要使用它，你需要确保该脚本在 $PATH 环境变量指定的路径中，或者你可以将它添加到 Git 的全局设置中以便自动使用（参见下文的配置文件部分）。

启动示例

在终端中，你可以直接运行 diff-so-fancy 来查看文件或目录的差异。例如：

$ diff-so-fancy file1.txt file2.txt

或者，如果你已经将其设置为 Git 的默认差异工具，可以像这样查看提交之间的差异：

$ git diff

3. 项目的配置文件介绍

diff-so-fancy 不需要特定的本地配置文件来运行。然而，为了全局启用它作为 Git 的默认差异数显示工具，你需要编辑或创建你的 Git 配置文件 ~/.gitconfig，并添加以下内容：

[core]
    pager = diff-so-fancy | less --SR --chop-long-lines

这行设置告诉 Git 使用 diff-so-fancy 显示差异，并通过 less 命令进行进一步的浏览控制。--SR 和 --chop-long-lines 参数可以优化长行的展示效果。

完成上述步骤后，每次运行 git diff 就会看到经过美化处理的差异对比了。

---

希望这份简短的指南帮助你成功安装和使用 diff-so-fancy。如需更详细的信息和高级用法，请参考项目的官方 GitHub 页面。