把 Apple ID 账号密码填进上传工具，点提交，结果不是认证失败就是卡在"需要验证身份"——手机上收到验证码，可工具里压根没地方填。不是你密码记错了，是苹果开发者账号全面启用双重认证之后，第三方上传工具不能再直接用 Apple ID 主密码登录了，得换一个叫 App 专用密码（App-specific password）的东西。
这篇讲清楚为什么要用它、在 appleid.apple.com 上怎么生成、粘到 Appuploader（开心上架）或命令行里怎么用，再说说它和 App Store Connect API 密钥各自适合什么场景。看完你上传 IPA 就不会再卡在登录这步。
为什么双重认证后非得用专用密码
双重认证的设计，是你每次在新设备登录 Apple ID，都要在受信任设备上确认、输一次动态验证码。这对人没问题，对第三方工具就卡住了——它没法走你手机上那次交互式确认，Apple 也不会把你的主密码和 2FA 流程开放给外部程序。
App 专用密码就是为了解决这个：它是你在 Apple 官方给某个第三方用途单独签发的一串密码，权限用于提交构建等操作，但和你的主密码隔离。工具拿这串密码去认证，不触发交互式 2FA；哪天不想让某个工具再用了，单独把这串撤销即可，不影响主密码和别的密码。
它有几个实际好处，记一下省得走弯路：
- 不会失效：生成一次长期可用，除非你主动撤销或改了 Apple ID 主密码。
- 可以生成多个：忘了之前那串也没关系，重新生成一串新的就行。
- 通用于不同 App 上架：一串密码能用于你名下所有 App 的提交，不用一个 App 配一串。
怎么生成：注意"名称"和"密码"是两回事
生成入口不在开发者后台，而在 Apple ID 账户页：
- 打开 appleid.apple.com 登录你的 Apple ID（就是开发者账号那个）。
- 找到 「App 专用密码」 这一项，点右侧的「+」或三点，新建一个。
- 它先让你填一个名称（比如写
appuploader或ci-upload，只是备注，方便你日后识别/撤销）。 - 确认后弹出框里出现的那串
xxxx-xxxx-xxxx-xxxx（四段、连字符分隔）才是真正的密码。
最容易踩的坑就在第 3、4 步：很多人把自己填的那个名称当成密码去用，当然登不进。记住——弹框里显示的那串带连字符的才是 App 专用密码，而且它只完整显示这一次，关掉就看不全了，当场复制好。
粘到 Appuploader 或命令行里用
拿到那串 xxxx-xxxx-xxxx-xxxx，用法就简单了。
在 Appuploader 里登录时，账号填你的 Apple ID、密码栏填这串专用密码，就能免掉交互式双重验证直接进去上传。Appuploader 登录成功后会把账号存进本地「已保存的账号」列表，下次直接点进入，不用重输——涉及私钥这类敏感凭据的操作它会再单独弹「验证身份」，这步是发给 Apple 官方校验的，不额外骚扰你。
如果你是写脚本自动上传，命令行同样认这串密码。配合 Appuploader 的 CLI：
# 把 Apple ID 和 App 专用密码交给上传命令（示意，密码建议走环境变量别写死）
appuploader-cli build upload ./build/App.ipa --wait
密码别明文写进脚本或提交进仓库，放环境变量或 CI 的加密变量里。苹果官方的 altool、xcrun altool --upload-app 这类命令，认证也是用同一串 App 专用密码，道理一样。
几个常见问题
问：这串密码会过期吗？要定期换吗？ 不会自动过期，生成一次长期有效。只有在你改了 Apple ID 主密码、或手动撤销它时才失效——改主密码会让所有已生成的专用密码一起作废，到时重新生成即可。
问：忘了之前生成的那串怎么办？ 没法再查看旧的（它只完整显示一次）。直接在账户页删掉旧的、重新生成一串新的，成本很低。
问：每个 App 都要单独生成一串吗？ 不用。一串专用密码通用于你名下所有 App 的提交。按用途分（比如本机手动一串、CI 一串）是为了方便单独撤销，不是必须。
问：把密码交给 Appuploader 这类工具，安全吗？
Appuploader 的做法是登录一次、本地保存会话，敏感操作再单独向 Apple 核验身份；API 密钥方式下 .p8 私钥只留在本地不上服务器。它没有公开完整的服务端加密细节，所以别信"绝对安全"这种话；但专用密码本身可随时在 Apple 侧单独撤销，这是它比直接用主密码更稳的地方。
专用密码 vs App Store Connect API 密钥，怎么选
除了 App 专用密码，还有一条认证路子是 App Store Connect API 密钥（一个 .p8 私钥文件 + Key ID + Issuer ID）。两者都能让工具免交互上传，但适用场景不同，列个表看得清楚：
| 对比项 | App 专用密码 | API 密钥（.p8） |
|---|---|---|
| 绑定对象 | 你的 Apple ID 个人账号 | App Store Connect 团队，可建多把、分角色权限 |
| 生成位置 | appleid.apple.com | App Store Connect → 用户与访问 → 密钥 |
| 适合场景 | 手动上传、个人/小团队、图省事 | CI/CD、自动化、团队协作、要精细权限 |
| 吊销粒度 | 单串撤销 | 单把密钥撤销，权限可控更细 |
| 上手成本 | 低，一串密码粘进去就行 | 略高，要管 .p8 文件和两个 ID |
简单说：你是在界面里手动点着上传、或者一个人维护几个 App，App 专用密码最省事；要是接 CI、多人协作、想按角色控制谁能干什么，API 密钥那套更合适。Appuploader 两种登录方式都支持，按你当前的上传方式挑一个就行。
