如何在GitHub上为自定义编程语言添加支持？

1. 理解GitHub的语言识别逻辑 #

GitHub依靠Linguist库识别仓库语言，核心依据是文件扩展名、语法特征和配置规则。要让自定义语言被识别，有两种路径：仓库内局部配置，或者提交修改到Linguist实现全局支持。

2. 仓库内局部配置（仅当前仓库生效） #

如果只需要自己的仓库识别该语言，按以下操作：

• 在仓库根目录创建 .gitattributes 文件，为自定义语言的文件扩展名指定识别规则。例如你的语言后缀是 .mylang，添加：

  *.mylang linguist-language=MyCustomLang
  

  其中MyCustomLang是你希望在语言列表中显示的名称。
• 若需要语法高亮，在仓库根目录创建 .github/linguist.yml 文件，配置语言的基础属性：

  languages:
    MyCustomLang:
      type: programming
      color: "#ff0000" # 替换为你想要的十六进制颜色码
      extensions:
        - .mylang
  

3. 全局支持（提交Linguist修改） #

如果希望所有GitHub仓库都能识别你的自定义语言，需要给Linguist官方仓库提交PR：

• 克隆Linguist仓库到本地
• 在lib/linguist/languages.yml中添加你的语言配置，包含名称、类型、颜色、扩展名等信息
• 在vendor/grammars目录添加该语言的TextMate格式语法高亮文件
• 编写测试用例验证识别和高亮功能
• 提交PR并等待官方审核合并

4. 验证生效 #

提交配置后推送到GitHub，等待几分钟刷新仓库页面即可。若未显示，排查以下点：

• 文件扩展名与配置是否匹配
• .gitattributes和.github/linguist.yml语法是否正确
• 仓库中自定义语言文件的占比是否足够（GitHub会忽略占比极低的语言）

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