GitHub 常见高频问题与解决方案(实用手册)

news2025/6/10 7:06:32

1.Push 提示权限错误(Permission denied)

问题:

Bash                  
Permission denied (publickey)                  
fatal: Could not read from remote repository.

原因: 没有配置 SSH key 或使用了 HTTPS 而没有权限。

解决方法:

Bash                  
生成 SSH 密钥(如果还没有)                  
ssh-keygen -t rsa -C "你的邮箱"                  
将生成的 ~/.ssh/id_rsa.pub 添加到 GitHub:Settings → SSH and GPG Keys

2.push 报错:rejected non-fast-forward

问题:

Bash                  
error: failed to push some refs to ...                  
hint: Updates were rejected because the tip of your current branch is behind ...

原因: 本地代码落后于远程,需要先 pull。

解决方法:

Bash                  
git pull origin main --rebase                  
然后再 push                  
git push origin main

3.忘记添加 .gitignore,上传了无关文件

解决方法:

1.添加或修改 .gitignore 文件

2.移除已跟踪的无用文件:

Bash                  
git rm -r --cached .                  
git add .                  
git commit -m "更新 .gitignore"                  
git push

4. 撤销最近一次 commit

方法 1:只改 commit 信息,不改内容

Bash                  
git commit --amend

方法 2:撤回 commit

Bash                  
git reset --soft HEAD~1  # 回退提交但保留改动

5.clone 太慢或失败

解决方法:

  • 使用国内镜像(如 GitHub 镜像或代理)
  • 或使用 SSH 克隆:

Bash                  
git clone git@github.com:xxx/xxx.git

6.如何切换/创建分支

Bash                  
创建并切换新分支                  
git checkout -b dev                  
切换已有分支                  
git checkout main

7.如何合并分支

Bash                  
git checkout main         # 切换到主分支                  
git merge dev             # 合并 dev 分支

有冲突时:

  • 手动解决文件冲突
  • git add . → git commit

8.如何删除远程分支

Bash                  
git push origin --delete 分支名

9.如何 Fork + PR(Pull Request)参与开源项目?

1.点击项目页面右上角 Fork

2.克隆到本地 → 创建新分支开发

3.提交 → Push 到自己仓库

4.打开自己仓库 → 点 "Compare & pull request"

5.提交 PR 给原项目

10.如何清除 Git 缓存的用户名密码?

Bash                  
git config --global --unset credential.helper

11.克隆仓库失败 / 速度慢

常见报错:

  • Connection timed out
  • fatal: unable to access ...

解决方案:

  • 使用 GitClone 镜像

Bash                  
git clone https://gitclone.com/github.com/user/repo.git

  • 或使用 SSH 克隆(加快速度):

Bash                  
git@github.com:user/repo.git

12. GitHub 提示需要访问 Token

报错示例:

Bash                  
remote: Support for password authentication was removed

原因:

  • GitHub 取消了账号密码登录 Git 操作(2021年后)

解决方案:

  • 生成 Personal Access Token
  • 用 token 代替密码进行 git pushclone

13. 如何修改或重命名仓库

路径:

仓库首页 → Settings → Repository name → 修改 → Save

注意:

  • 更改会改变仓库 URL,需要重新 clone 或更新 remote。

14. 如何同步 Fork 仓库

步骤:

Bash                  
git remote add upstream https://github.com/原作者/repo.git                  
git fetch upstream                  
git merge upstream/main

或使用 rebase 替代 merge 保持提交整洁。

15. 误删了远程分支怎么办?

如果本地还有该分支:

Bash                  
git push origin 分支名

如果本地也没有:

  • 从另一个开发者获取代码
  • 或查看 Pull Request 恢复提交内容

16. 如何设置仓库私密 / 公开

路径:仓库首页 → Settings → Danger Zone → Change visibility

17. 如何上传大文件(>100MB)

GitHub 限制单文件大小为 100MB

解决方案:

  • 使用 Git Large File Storage(Git LFS

Bash                  
git lfs install                  
git lfs track "*.zip"

18. Actions 运行失败

常见原因:

  • 缺少权限(例如私有仓库)
  • secrets 配置错误
  • 网络原因(如下载超时)

排查建议:

  • 查看 Actions logs
  • 增加超时或使用国内依赖镜像源
  • 设置 secrets 时确保 key/value 正确拼写

19. 删除仓库后能恢复吗?

仓库一旦删除,GitHub 不支持恢复

建议开启删除保护(Settings → Enable delete protection)

20. Pull Request 无法合并

原因可能包括:

  • 有冲突(conflict)
  • 分支不是目标分支的子分支
  • 权限不足(需有 write 权限)

解决方案:

Bash                  
git fetch origin                  
git rebase origin/main                  
解决冲突后                  
git push -f

21. 访问 GitHub 卡顿 / 加载慢

使用加速方式:

  • https://ghproxy.com/
  • https://gitclone.com/
  • DNS 优化(如 223.5.5.5)
  • 临时 hosts:使用 GitHub520

22. 贡献指南 CONTRIBUTING.md 不生效?

确保文件路径正确为:

Plain Text                  
/.github/CONTRIBUTING.md

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/2406335.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

数据可视化交互

目录 【实验目的】 【实验原理】 【实验环境】 【实验步骤】 一、安装 pyecharts 二、下载数据 三、实验任务 实验 1:AQI 横向对比条形图 代码说明: 运行结果: 实验 2:AQI 等级分布饼图 实验 3:多城市 AQI…

安宝特方案丨从依赖经验到数据驱动:AR套件重构特种装备装配与质检全流程

在高压电气装备、军工装备、石油测井仪器装备、计算存储服务器和机柜、核磁医疗装备、大型发动机组等特种装备生产型企业,其产品具有“小批量、多品种、人工装配、价值高”的特点。 生产管理中存在传统SOP文件内容缺失、SOP更新不及、装配严重依赖个人经验、产品装…

【JavaEE】万字详解HTTP协议

HTTP是什么?-----互联网的“快递小哥” 想象我们正在网上购物:打开淘宝APP,搜索“蓝牙耳机”,点击商品图片,然后下单付款。这一系列操作背后,其实有一个看不见的“快递小哥”在帮我们传递信息,…

华为云Flexus+DeepSeek征文 | MaaS平台避坑指南:DeepSeek商用服务开通与成本控制

作者简介 我是摘星,一名专注于云计算和AI技术的开发者。本次通过华为云MaaS平台体验DeepSeek系列模型,将实际使用经验分享给大家,希望能帮助开发者快速掌握华为云AI服务的核心能力。 目录 作者简介 前言 一、技术架构概览 1.1 整体架构设…

【动态规划】B4336 [中山市赛 2023] 永别|普及+

B4336 [中山市赛 2023] 永别 题目描述 你做了一个梦,梦里有一个字符串,这个字符串无论正着读还是倒着读都是一样的,例如: a b c b a \tt abcba abcba 就符合这个条件。 但是你醒来时不记得梦中的字符串是什么,只记得…

可下载旧版app屏蔽更新的app市场

软件介绍 手机用久了,app越来越臃肿,老手机卡顿成常态。这里给大家推荐个改善老手机使用体验的方法,还能帮我们卸载不需要的app。 手机现状 如今的app不断更新,看似在优化,实则内存占用越来越大,对手机性…

claude3.7高阶玩法,生成系统架构图,国内直接使用

文章目录 零、前言一、操作指南操作指导 二、提示词模板三、实战图书管理系统通过4o模型生成系统描述通过claude3.7生成系统架构图svg代码转换成图片 在线考试系统通过4o模型生成系统描述通过claude3.7生成系统架构图svg代码转换成图片 四、感受 零、前言 现在很多AI大模型可以…

河北对口计算机高考MySQL笔记(完结版)(2026高考)持续更新~~~~

MySQL 基础概念 数据(Data):文本,数字,图片,视频,音频等多种表现形式,能够被计算机存储和处理。 **数据库(Data Base—简称DB):**存储数据的仓库…

2025-06-01-Hive 技术及应用介绍

Hive 技术及应用介绍 参考资料 Hive 技术原理Hive 架构及应用介绍Hive - 小海哥哥 de - 博客园https://cwiki.apache.org/confluence/display/Hive/Home(官方文档) Apache Hive 是基于 Hadoop 构建的数据仓库工具,它为海量结构化数据提供类 SQL 的查询能力&#xf…

AI书签管理工具开发全记录(十八):书签导入导出

文章目录 AI书签管理工具开发全记录(十八):书签导入导出1.前言 📝2.书签结构分析 📖3.书签示例 📑4.书签文件结构定义描述 🔣4.1. ​整体文档结构​​4.2. ​核心元素类型​​4.3. ​层级关系4.…

docker容器互联

1.docker可以通过网路访问 2.docker允许映射容器内应用的服务端口到本地宿主主机 3.互联机制实现多个容器间通过容器名来快速访问 一 、端口映射实现容器访问 1.从外部访问容器应用 我们先把之前的删掉吧(如果不删的话,容器就提不起来,因…

安宝特案例丨寻医不再长途跋涉?Vuzix再次以AR技术智能驱动远程医疗

加拿大领先科技公司TeleVU基于Vuzix智能眼镜打造远程医疗生态系统,彻底革新患者护理模式。 安宝特合作伙伴TeleVU成立30余年,沉淀医疗技术、计算机科学与人工智能经验,聚焦医疗保健领域,提供AR、AI、IoT解决方案。 该方案使医疗…

Modbus转Ethernet IP深度解析:磨粉设备效率跃升的底层技术密码

在建材矿粉磨系统中,开疆智能Modbus转Ethernet IP网关KJ-EIP-101的应用案例是一个重要的技术革新。这个转换过程涉及到两种主要的通信协议:Modbus和Ethernet IP。Modbus是一种串行通信协议,广泛应用于工业控制系统中。它简单、易于部署和维护…

在MobaXterm 打开图形工具firefox

目录 1.安装 X 服务器软件 2.服务器端配置 3.客户端配置 4.安装并打开 Firefox 1.安装 X 服务器软件 Centos系统 # CentOS/RHEL 7 及之前(YUM) sudo yum install xorg-x11-server-Xorg xorg-x11-xinit xorg-x11-utils mesa-libEGL mesa-libGL mesa-…

旋量理论:刚体运动的几何描述与机器人应用

旋量理论为描述刚体在三维空间中的运动提供了强大而优雅的数学框架。与传统的欧拉角或方向余弦矩阵相比,旋量理论通过螺旋运动的概念统一了旋转和平移,在机器人学、计算机图形学和多体动力学领域具有显著优势。这种描述不仅几何直观,而且计算…

运动控制--BLDC电机

一、电机的分类 按照供电电源 1.直流电机 1.1 有刷直流电机(BDC) 通过电刷与换向器实现电流方向切换,典型应用于电动工具、玩具等 1.2 无刷直流电机(BLDC) 电子换向替代机械电刷,具有高可靠性,常用于无人机、高端家电…

Redis专题-实战篇一-基于Session和Redis实现登录业务

GitHub项目地址:https://github.com/whltaoin/redisLearningProject_hm-dianping 基于Session实现登录业务功能提交版本码:e34399f 基于Redis实现登录业务提交版本码:60bf740 一、导入黑马点评后端项目 项目架构图 1. 前期阶段2. 后续阶段导…

【前端实战】如何让用户回到上次阅读的位置?

目录 【前端实战】如何让用户回到上次阅读的位置? 一、总体思路 1、核心目标 2、涉及到的技术 二、实现方案详解 1、基础方法:监听滚动,记录 scrollTop(不推荐) 2、Intersection Observer 插入探针元素 3、基…

dvwa11——XSS(Reflected)

LOW 分析源码&#xff1a;无过滤 和上一关一样&#xff0c;这一关在输入框内输入&#xff0c;成功回显 <script>alert(relee);</script> MEDIUM 分析源码&#xff0c;是把<script>替换成了空格&#xff0c;但没有禁用大写 改大写即可&#xff0c;注意函数…

【Axure高保真原型】图片列表添加和删除图片

今天和大家分享图片列表添加和删除图片的原型模板&#xff0c;效果包括&#xff1a; 点击图片列表的加号可以显示图片选择器&#xff0c;选择里面的图片&#xff1b; 选择图片后点击添加按钮&#xff0c;可以将该图片添加到图片列表&#xff1b; 鼠标移入图片列表的图片&…