如何获取GitHub私有仓库中RAW文件的永久链接？

一、先把链接格式盯准了 #

别小看格式，很多404都是这里错的。正确的格式必须是：
https://<你的完整令牌>@raw.githubusercontent.com/<用户名/组织名>/<仓库名>/<分支/Commit哈希>/<完整文件路径>
几个容易踩的坑：

• 令牌要完整复制，别漏了开头的前缀（比如ghp_、github_pat_这些都要带上）
• 分支名如果换成Commit哈希（这才是真正的永久链接，分支更新了也不影响），一定要用完整的40位哈希值，别截短
• 文件路径要和仓库里的完全一致，比如文件在src/utils/helper.js，就不能只写helper.js

二、令牌权限必须给够 #

不管是细粒度还是经典令牌，权限不对直接白搭：

经典令牌 #

• 必须勾选repo权限，这是访问私有仓库的核心，其他权限不用瞎勾
• 确保令牌没过期，生成的时候别选太短的有效期

细粒度令牌 #

• 仓库选择特定仓库，指定你要访问的那个私有仓库，别选“所有仓库”（反而可能出问题）
• 内容权限设为读取（Read），这就够了，不用给写入权限
• 检查令牌的有效期，过期了就重新生成一个

三、排查404的常见细节 #

• 令牌里有特殊字符？比如/、=这类，得做URL编码（随便搜个在线URL编码工具，把令牌转一下再放进链接里）
• 文件路径复制错了？去仓库里打开目标文件，点右上角的Raw按钮，复制地址栏里除了https://raw.githubusercontent.com/之外的部分，直接粘到你的链接里
• 仓库是组织的？别用你个人的用户名，要用组织名，比如仓库属于my-org，就写my-org而不是你的用户名
• 分支名拼错了？比如现在很多仓库默认分支是main不是master，别搞混

四、换GitHub API方法试试 #

如果上面的方法还是不行，用GitHub API更稳妥：
直接用这个格式的链接（把占位符替换成你的信息）：
https://<你的令牌>@api.github.com/repos/<用户名/组织名>/<仓库名>/contents/<文件路径>?ref=<分支/Commit哈希>
打开这个链接后，返回的JSON里有个download_url字段，这个就是能直接在浏览器打开的RAW文件永久链接，复制下来用就行

五、先在命令行测试 #

怕浏览器缓存或者其他问题？先在终端用curl测一下：
curl -I "https://<你的令牌>@raw.githubusercontent.com/<用户名/组织名>/<仓库名>/<Commit哈希>/<文件路径>"
如果返回200 OK，说明链接没问题，清一下浏览器缓存再试；如果还是404，回头再检查权限和格式

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