Z/OS USS上Git稀疏克隆遇“未暂存更改”错误的解决咨询

问题根源在于Z/OS USS默认使用EBCDIC编码，而GitHub仓库文件采用ASCII/UTF-8编码，克隆时Git的自动字符转换篡改了README.md内容（比如don't变成dont），导致工作区出现未暂存更改，阻断了稀疏检出操作。通过Git属性配置可以彻底解决这个问题，具体步骤如下：

针对已克隆仓库的修复步骤 #

1. 先恢复工作区到干净状态：

   git reset --hard HEAD
   

2. 在仓库根目录创建或编辑.gitattributes文件，添加以下规则：

   README.md text encoding=utf-8 eol=lf
   * text=auto
   

   这条规则强制Git以UTF-8编码处理README.md，使用LF换行，完全规避Z/OS的EBCDIC编码转换干扰。
3. 让Git按照新属性重新拉取README.md：

   git checkout HEAD -- README.md
   

4. 此时执行稀疏检出操作即可正常运行：

   git sparse-checkout add JustThisDir
   

克隆前的预防配置 #

如果后续还要克隆同类仓库，可先全局配置Git的编码和换行规则，避免重复踩坑：

git config --global core.encoding utf-8
git config --global core.autocrlf false

也可以提前将.gitattributes文件提交到仓库中，确保所有环境克隆时都会自动应用正确的文件处理规则。

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