Git 属性文件（`.gitattributes`）的语法校验

错误核心分析

每条报错格式为：不允许 [attr] <属性设置>：<文件路径>:<行号>，表明 Git 检测到属性语法或逻辑错误。常见原因包括：

1. 属性语法错误：如无效的属性名、错误的参数格式。
2. 属性冲突：同一文件配置了矛盾的属性（如同时设置 eol=lf 和 eol=crlf）。
3. 未知属性：使用了 Git 不支持的属性或拼写错误。

具体错误解析

1. 不允许 [attr]eol=text:...

• 问题：eol=text 是无效属性组合。Git 中 eol 属性需明确指定行结束符（如 eol=lf 或 eol=crlf），text 是独立属性（控制是否进行行结束符转换），二者不能直接合并。
• 修正：若需设置文本文件并指定 LF 结束符，应拆分为：
  * text eol=lf（通配所有文本文件）或针对特定文件：
  *.py text eol=lf。

2. 不允许 [attr]dos text eol=crlf:...

• 问题：dos text 是旧版 Git 语法（现已废弃），现代 Git 推荐直接用 eol=crlf。此外，dos 属性可能与 text 冗余。
• 修正：简化为 *.txt text eol=crlf（若需指定特定文件类型使用 CRLF 结束符）。

3. 不允许 [attr]generated linguist-generated=true diff=generated:...

• 问题：属性顺序或格式错误。linguist-generated=true 和 diff=generated 是有效属性，但 generated 并非独立属性（可能是拼写错误，应为 diff=generated 或通过 linguist 插件识别）。
• 修正：参考 Git 官方文档，正确标记生成文件：
  *.gen linguist-generated=true diff=generated（需确保文件扩展名匹配）。

4. 允许的行（对比参考）

• 最后一行 允许 [attr]rust text eol=lf whitespace=tab-in-indent,trailing-space,tabwidth=4:... 语法正确，可作为模板：
  • rust 是文件扩展名（匹配 .rust 文件）
  • text eol=lf 指定文本模式和 LF 结束符
  • whitespace=... 是合法的空白字符检查参数（多个参数用逗号分隔）。

解决步骤

1. 校验 .gitattributes 语法：
   确保每行属性符合 pattern attr1=value1 attr2=value2 ... 格式，属性间用空格分隔，无多余符号。
   示例：

   # 正确格式
   *.py text eol=lf
   *.dll -text       # 标记二进制文件，禁止行结束符转换
   *.md linguist-documentation   # 使用 linguist 插件分类
   

2. 避免冲突属性：

   • 不要同时设置 eol=lf 和 eol=crlf（二者互斥）。
   • text 属性用于启用行结束符转换，-text 表示禁用（二进制文件应标记为 -text）。

3. 参考官方文档：

   • Git 属性语法：gitattributes Documentation
   • 生成文件标记：使用 linguist-generated 或 diff 属性需确保插件已启用。

4. 修复后验证：
   运行 git add .gitattributes 并提交，观察是否仍有报错，或通过 git check-attr 命令验证属性生效情况。

总结

核心问题是 .gitattributes 文件中存在无效或冲突的属性声明，需按照 Git 官方语法规范逐一修正，确保每行属性格式正确、参数合法且无逻辑矛盾。重点检查 eol、text、linguist 等属性的用法，参考标准模板调整配置。