GitLab中.gitattributes配置Linguist识别GameMaker文件失效问题

1. 先明确GitLab的语言识别逻辑 #

GitLab采用GitHub Linguist的定制版本，部分规则和官方文档存在差异。GameMaker的.yy/.yyp本质是JSON结构，但Linguist中GameMaker Language和GameMaker JSON是两个独立分类，必须精准指定文件归属。

2. 修正.gitattributes的精确配置 #

直接指定文件类型为GameMaker JSON，同时强制开启检测，避免默认规则覆盖：

*.yy linguist-language=GameMaker JSON
*.yy linguist-detectable=true
*.yyp linguist-language=GameMaker JSON
*.yyp linguist-detectable=true

注意：语言名称必须和Linguist内置条目完全一致，不能出现拼写错误。

3. 强制刷新GitLab的语言缓存 #

GitLab会缓存语言统计结果，仅推送.gitattributes可能不会立即更新，可通过以下方式触发重新扫描：

• 做一次无意义的提交（比如修改README的空格后再改回）并推送
• 进入仓库「设置」-「通用」页面，找到「高级」选项，点击「重新计算仓库语言」（部分GitLab版本提供该按钮）

4. 验证文件的JSON结构合规性 #

如果.yy/.yyp文件本身不符合标准JSON格式，Linguist会自动 fallback 到GameMaker Language：

• 使用JSON校验工具检查几个核心.yy/.yyp文件，确保无语法错误
• 确认文件开头为{或[，符合JSON的基础结构特征

5. 明确标记其他GameMaker文件 #

若仓库内存在大量.gml脚本文件，Linguist可能优先统计占比更高的类型，可给.gml文件也添加标记：

*.gml linguist-language=GameMaker Language

避免.gml的统计数据覆盖JSON文件的识别结果。

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