如何为demo项目正确配置.gitattributes覆盖GitHub linguist识别规则

配置不生效的核心原因 #

1. 你当前写入的demo/** linguist-documentation规则作用是将demo目录下所有文件标记为文档文件，linguist默认会排除文档文件不计入语言统计，和你要让linguist正常扫描的需求完全相反。
2. .gitattributes必须放在Git仓库的根目录（也就是执行git init生成.git文件夹的同级目录）才会全局生效：如果你的Git仓库本身就是demo目录，那你把文件放在demo的同级位置是完全不会生效的，需要先把.gitattributes移动到demo目录的根路径下。

对应配置方案 #

根据你的实际情况选择对应规则写入.gitattributes即可：

• 如果你需要让linguist正常统计demo目录的所有代码：直接删除你之前添加的demo/** linguist-documentation规则即可，没有特殊排除规则的情况下linguist会自动扫描该目录。
• 如果你要明确声明demo目录为需要统计的源码目录：添加如下规则

  demo/** linguist-documentation=false
  

• 如果你需要修正demo目录下特定文件的语言识别：比如将所有.tsx文件识别为TypeScript，可添加对应规则

  demo/**/*.tsx linguist-language=TypeScript
  

本地验证方法 #

配置提交到Git后，你可以在本地安装linguist工具直接验证规则是否生效，无需推送到GitHub等待更新：

github-linguist --breakdown

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