12：【GitHub PAT】Personal Access Token过期/2FA后HTTPS推送失败（2026仍高频）

# 1. 登录GitHub
# 2. 访问 Settings → Developer settings → Personal access tokens → Tokens (classic)
# 3. 点击 "Generate new token"
# 4. 设置 token 名称、过期时间和权限
# 5. 复制生成的 PAT（只显示一次）

# 验证PAT格式
# PAT格式：ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 1. 登录GitHub
# 2. 访问 Settings → Developer settings → Personal access tokens → Fine-grained tokens
# 3. 点击 "Generate new token"
# 4. 设置 token 名称、过期时间、仓库访问权限等
# 5. 复制生成的 PAT（只显示一次）

# 克隆仓库时使用PAT
git clone https://ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx@github.com/username/repository.git

# 或修改现有仓库的远程URL
git remote set-url origin https://ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx@github.com/username/repository.git

# 验证远程URL
git remote -v

# Windows
# 1. 打开控制面板 → 用户账户 → 凭据管理器 → Windows凭据
# 2. 添加通用凭据
#    - 互联网或网络地址: git:https://github.com
#    - 用户名为任意值（如 "git"）
#    - 密码为你的PAT

# macOS
# 使用Keychain Access
# 1. 打开Keychain Access
# 2. 搜索 "github.com"
# 3. 更新或添加条目，使用PAT作为密码

# Linux
# 使用libsecret
# 1. 安装依赖
sudo apt-get install libsecret-1-0 libsecret-1-dev
# 2. 编译Git凭证助手
cd /usr/share/doc/git/contrib/credential/libsecret
sudo make
# 3. 配置Git使用该凭证助手
git config --global credential.helper /usr/share/doc/git/contrib/credential/libsecret/git-credential-libsecret

# 配置Git使用凭证助手
git config --global credential.helper cache

# 设置缓存时间（秒）
git config --global credential.helper 'cache --timeout=3600'

# 首次推送时输入用户名（任意）和密码（PAT）
git push
# 之后Git会缓存凭证，无需重复输入

# 1. 创建新的PAT（参考步骤1）

# 2. 更新Git凭证
# Windows：在凭据管理器中更新
# macOS：在Keychain Access中更新
# Linux：清除缓存后重新输入

# 清除Git缓存
git credential-cache exit

# 重新推送以输入新PAT
git push

#!/bin/bash

# PAT轮换脚本

# 配置
GITHUB_USER="username"
REPOSITORY="repository"
NEW_PAT="ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 更新远程URL
git remote set-url origin https://$NEW_PAT@github.com/$GITHUB_USER/$REPOSITORY.git

# 验证更新
echo "更新远程URL成功:"
git remote -v

# 测试推送
echo "测试推送..."
git push --dry-run

if [ $? -eq 0 ]; then
    echo "✅ PAT更新成功，推送测试通过"
else
    echo "❌ PAT更新失败，推送测试失败"
    exit 1
fi

# 1. 创建PAT（参考步骤1）
# 2. 配置Git使用PAT（参考步骤2）
# 3. 推送代码
git push
# 此时不需要2FA验证，因为PAT已经包含了认证信息

# 1. 生成SSH密钥
ssh-keygen -t ed25519 -C "your_email@example.com"

# 2. 将SSH公钥添加到GitHub
# 访问 Settings → SSH and GPG keys → New SSH key
# 复制 ~/.ssh/id_ed25519.pub 的内容

# 3. 修改远程URL为SSH格式
git remote set-url origin git@github.com:username/repository.git

# 4. 验证SSH连接
ssh -T git@github.com

# 5. 推送代码
git push

# 症状：
# remote: Invalid username or password.
# fatal: Authentication failed for 'https://github.com/username/repository.git/'

# 解决方案：
# 1. 登录GitHub，检查PAT状态
# 2. 创建新的PAT
# 3. 更新Git凭证
# 4. 测试推送

# 症状：
# 推送时提示需要2FA验证，但无法完成

# 解决方案：
# 1. 创建PAT（PAT不需要2FA验证）
# 2. 配置Git使用PAT
# 3. 重新推送

# 症状：
# 即使更新了PAT，仍然推送失败

# 解决方案：
# 清除Git凭证缓存

# Windows：在凭据管理器中删除GitHub条目
# macOS：在Keychain Access中删除GitHub条目
# Linux：
git credential-cache exit

# 重新输入PAT
git push

# 解决方案：

# 1. 检查错误信息
# 错误示例：remote: Invalid username or password.

# 2. 登录GitHub，创建新的PAT
# 访问 Settings → Developer settings → Personal access tokens

# 3. 更新Git凭证
# Windows：凭据管理器
# macOS：Keychain Access
# Linux：git credential-cache exit

# 4. 测试推送
git push

# 解决方案：

# 1. 创建PAT（PAT不需要2FA验证）
# 访问 Settings → Developer settings → Personal access tokens

# 2. 配置Git使用PAT
# 方法1：修改远程URL
git remote set-url origin https://ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx@github.com/username/repository.git

# 方法2：使用凭证助手
git config --global credential.helper cache
git push  # 首次推送时输入PAT

# 3. 测试推送
git push

# 解决方案：

# 1. 创建专用的CI/CD PAT
# 设置较短的过期时间和必要的权限

# 2. 在CI/CD平台中设置环境变量
# GitHub Actions示例（在仓库 Settings → Secrets and variables → Actions 中设置）
# GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}  # 或使用自定义PAT

# 3. 配置PAT轮换策略
# 使用GitHub Actions定期更新PAT

# 4. 监控PAT使用情况
# 启用GitHub的安全警报

# 1. 创建细粒度PAT（推荐）
# - 设置有意义的名称
# - 设置合理的过期时间（如30天）
# - 只选择必要的权限
# - 限制仓库访问范围

# 2. 为不同用途创建不同的PAT
# - 开发用PAT
# - CI/CD用PAT
# - 测试用PAT

# 3. 安全存储PAT
# - 使用密码管理器
# - 避免将PAT硬编码到代码中
# - 避免在日志中打印PAT

# 配置Git凭证助手

# Windows
git config --global credential.helper manager

# macOS
git config --global credential.helper osxkeychain

# Linux
git config --global credential.helper cache

# 设置缓存时间（秒）
git config --global credential.helper 'cache --timeout=86400'  # 24小时

# 验证配置
git config --global credential.helper