Mac克隆GitHub仓库后PDF文件显示修改，常规Git操作无效如何解决？

兄弟，这种跨系统搞Git碰到二进制文件的异常我太熟了！你用2017款MacBook Air，队友用Linux Mint，克隆仓库后PDF一直显示已修改，试了checkout、reset、stash甚至改配置都没用，大概率是Git对二进制文件的处理逻辑或者跨系统的文件属性差异在捣鬼，给你几个亲测有效的解决步骤：

1. 强制Git将PDF识别为二进制文件 #

Git有时候会误把某些二进制文件当成文本处理，尤其是跨系统时换行符规则差异可能触发误判。直接在仓库根目录配置.gitattributes来指定PDF的处理规则：

# 编辑或创建.gitattributes文件，添加PDF的二进制规则
echo "*.pdf binary" >> .gitattributes

# 提交这个配置文件，让所有贡献者都能受益
git add .gitattributes
git commit -m "Force PDF files to be treated as binary to avoid cross-system conflicts"

提交后重新拉取仓库，或者执行git reset --hard HEAD刷新本地文件，再看git status应该能解决文本/二进制误判的问题。

2. 彻底关闭Git的文件权限检测 #

Mac和Linux的文件权限表示有细微差异，即使你改了仓库级的config.filemode，可能全局配置还在生效。直接全局关闭这个检测：

git config --global core.filemode false

执行完后，建议重新克隆一次仓库（或者在现有仓库执行git reset --hard HEAD），这样Git就不会把权限变化当成文件修改了。

3. 清理Git索引缓存，强制刷新文件状态 #

有时候Git的索引里残留了旧的文件状态，就算你删除文件重新拉取也没用。手动清理缓存并重新检出文件：

# 先从Git缓存中移除异常的PDF文件
git rm --cached path/to/your/target.pdf

# 从HEAD重新检出该文件，强制同步索引和本地文件
git checkout HEAD -- path/to/your/target.pdf

执行完后再跑git status，应该能看到PDF文件不再显示已修改。

4. 移除MacOS给文件添加的扩展属性 #

MacOS会给下载或创建的文件添加一些扩展属性（比如隔离标记com.apple.quarantine），Git会把这些属性的变化当成文件修改。先检查文件是否有扩展属性：

xattr path/to/your/target.pdf

如果输出有内容，说明存在扩展属性，直接清除：

xattr -c path/to/your/target.pdf

要是经常遇到这个问题，可以把下面的规则加到.gitattributes里，彻底禁用Git对PDF文件的文本相关处理：

*.pdf -crlf -diff -merge -text

内容的提问来源于stack exchange，提问作者Sathishkumar