如何为GitHub App设置精细仓库权限？解析授权与安装差异

我正在构建一款可连接用户GitHub仓库的Web服务，为此创建并配置了一个GitHub App。在该GitHub App的设置页面中，我看到一个安装按钮：

点击安装后，跳转至链接 https://github.com/apps/test-app/installations/new/permissions?target_id=abcdefgh，进入的界面可以让用户选择GitHub App能访问的仓库，这正是我需要的效果。但通过常规GitHub App流程操作时，却出现了完全不同的安装对话框，其中“代表你执行操作”的措辞也不合适。请问我哪里操作有误？

另外，我在GitHub官方文档中看到：

你可以在不授权GitHub App的情况下安装它。同样，你也可以在不安装它的情况下授权该App。

因此我想了解：GitHub App的授权与安装究竟有何区别？

一、安装对话框差异的原因 #

你看到的两种不同界面，本质是纯安装流程和授权+安装合并流程的区别：

• 从GitHub App设置页面点击安装按钮，触发的是纯安装流程：核心是让用户选择App可访问的仓库/组织，分配仓库级访问权限，此时App以自身身份（而非用户身份）访问仓库资源。
• 你走的“常规流程”大概率触发了授权+安装的合并流程：如果你的App配置了需获取用户个人数据的权限（比如读取用户邮箱、个人仓库权限等），或是使用了带scope参数的授权链接，GitHub会将安装和授权合并为一个流程，这时就会出现“代表你执行操作”的提示——因为这一步不仅要给仓库安装App，还要授权App以你的身份执行操作。

修正操作建议 #

要确保触发纯安装流程，你需要：

1. 检查GitHub App权限配置：如果不需要访问用户个人数据（仅需仓库级的代码读写权限），不要勾选用户相关权限（比如“用户 > 邮箱地址”这类个人权限）。
2. 使用正确的安装链接：直接使用格式为 https://github.com/apps/[你的App名称]/installations/new 的链接，不要添加任何授权相关的scope参数，就能直接进入选择仓库的安装界面。

二、GitHub App授权与安装的核心区别 #

1. 安装（Installation） #

• 作用：将App部署到特定GitHub组织或个人账户下，分配App可访问的仓库范围，同时生成安装令牌（Installation Token）。
• 身份：App以自身独立身份访问仓库资源，所有操作记录显示为App名称，而非用户个人账号。
• 适用场景：仅需App访问仓库内代码、Issue、PR等资源，不需要代表用户执行操作时，仅需安装即可。

2. 授权（Authorization） #

• 作用：让App获取用户的个人身份令牌（OAuth Token），获得代表用户执行操作的权限，比如创建Gist、访问用户私有个人仓库、读取用户个人信息等。
• 身份：App会以用户身份执行操作，操作记录显示为用户个人账号名称。
• 适用场景：App需要执行用户专属操作（比如用用户身份提交代码、管理用户个人仓库）时，才需要用户授权。

简单总结：安装是给App分配仓库访问权限，授权是给App“代你做事”的身份权限，二者完全独立，可分开操作。

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