Git

Articles

FAQ

GitHub push 报 ‘Permission denied (publickey)’

原因：本地 SSH key 未注册到 GitHub。

解法：

# 1. 查看本地公钥
cat ~/.ssh/id_ed25519.pub
# 2. 复制到 GitHub → Settings → SSH and GPG keys → New SSH key
# 3. 测试连接
ssh -T git@github.com
GitHub Deploy Key 是什么？怎么用？

Deploy Key 是绑定到单个仓库的 SSH key，只对该仓库有读写权限。

生成：

ssh-keygen -t ed25519 -f opencode-deploy-key -C "my-repo-deploy"

配置：

  1. 公钥添加到 GitHub repo → Settings → Deploy keys → Add deploy key（勾 Write access）
  2. 私钥用于 Git 操作： 
    GIT_SSH_COMMAND="ssh -i /path/to/opencode-deploy-key" git push

用途：常用于 CI/CD 或容器内 Git 操作，权限范围最小。

GitHub Actions 报错 ‘The request URL returned error 403’

原因：GitHub token 权限不足或过期。

解法：

  1. 去 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) 重新生成
  2. 确保勾选了 repo 和 workflow 权限
  3. 更新仓库的 Secrets → 替换旧的 token
Git submodule 更新失败

现象：git submodule update --init --depth 1 卡住或报错。

原因：子模块仓库访问慢或不存在。

解法：

# 使用代理
git -c http.proxy=http://proxy:port submodule update --init

# 或换源（如使用 ghproxy）
git submodule set-url themes/my-theme https://ghproxy.org/https://github.com/xxx/my-theme.git
git submodule update --init
国内 git clone 太慢怎么办

方案一：使用 ghfast.top 代理

git clone https://ghfast.top/https://github.com/user/repo.git

方案二：配置 URL 重写（全局生效）

git config --global url."https://ghfast.top/https://github.com/".insteadOf "https://github.com/"

方案三：使用 Gitee 镜像

  1. 在 Gitee 上 import 目标仓库
  2. 从 Gitee clone（速度很快）