{count, plural, other {课程}}
Git 入门
{hours} 小时
102.1K
如何在 GitHub 上删除存储库
删除 GitHub 存储库很容易，但 GitHub 内置了若干确认步骤，以确保您不会误删重要内容。
>只想删除分支而不是整个存储库？请参考这篇操作指南。
我将通过清晰的说明逐步引导您完成整个流程，帮助您安全地从账户中移除不需要的存储库。
步骤 1：进入存储库设置
开始删除存储库前，您需要先进入其设置：
- 登录您的 GitHub 账户，打开要删除的存储库。
- 在存储库名称下方的顶部导航栏，找到并点击“Settings（设置）”选项卡（齿轮图标）。
这会进入存储库的设置页面，您可以在这里管理存储库的不同方面：
图片 1 - GitHub 存储库设置
请确保您拥有该存储库的相应权限。如果您不是所有者或没有管理员权限，将无法访问这些设置或删除存储库。
步骤 2：找到“Danger Zone（危险区域）”
GitHub 会将最具破坏性的操作集中在一个明显标注的区域。前往该区域的方法如下：
- 将设置页面一路滚动到最底部。
- 查找带有红色边框并标有“Danger Zone”的部分。
该部分包含一些可能带来破坏性的操作，例如更改存储库可见性、转移和删除选项：
图片 2 - GitHub 存储库危险区域设置
“Danger Zone” 被有意放在页面底部并以红色标示，以防止误触。这是您的第一个视觉警示：您即将执行可能带来重大后果的操作。
步骤 3：点击“Delete this repository（删除此存储库）”
找到危险区域后，您即可开始删除流程：
- 在危险区域内，找到“Delete this repository（删除此存储库）”按钮。
- 点击该按钮，开始删除流程。
此时会弹出对话框，要求您确认操作意图：
图片 3 - 开始删除 GitHub 存储库
如果您确认要继续，GitHub 还会显示一条额外的警告消息，强调该操作无法撤销：
图片 4 - 开始删除 GitHub 存储库（2）
在此时刻请再三确认，您确实要继续删除该存储库。
步骤 4：确认删除
GitHub 通过验证步骤防止误删：
- 在确认对话框中，系统会要求您输入存储库的完整名称（包括您的用户名）。
- 请按对话框中显示，准确输入存储库名称。
- 在您正确输入名称之前，删除按钮将保持禁用。
图片 5 - 开始删除 GitHub 存储库（3）
通过要求您手动输入存储库名称，GitHub 可确保您是在做出深思熟虑的决定，而不是不看内容就一路点确认。这有助于防止误删错误的存储库，尤其当您打开了多个标签页时。
步骤 5：完成删除
在您确认要删除存储库后，系统可能会要求您重新登录 GitHub 账户，或通过双重验证（2FA）校验您的凭据：
图片 6 - GitHub 2FA 提示
以我的情况为例，我需要输入验证器代码。完成后，您会看到一条成功消息，表明删除流程已完成：
图片 7 - 成功删除 GitHub 存储库
就是这样！您的存储库及其所有 Issue、Pull Request、Wiki 和其他相关数据现已从 GitHub 上彻底移除。请记住，此操作是永久性的，GitHub 无法恢复已删除的存储库，因此在完成此流程前，请务必备份任何重要数据。
删除存储库前需要考虑的事项
在您点击最终删除按钮之前，有几个重要因素需要考虑。
>是否能在 Git 与 GitHub 上移除未跟踪文件？git clean 命令正是您需要的。
删除存储库会带来 连锁影响，不仅仅是从您的账户中移除文件。请务必花点时间审视这些考量，避免出现意外后果。
对派生（fork）的影响
当您删除一个存储库时，其他用户基于您的存储库创建的任何派生将继续独立存在。
换句话说，删除您的存储库不会影响或删除他人创建的派生。这些派生将失去与原始存储库的连接，成为独立的存储库。
如果派生的所有者尝试发起 Pull Request 或与您的原始存储库同步，他们会遇到错误。
这可能会让那些已派生并积极参与贡献的开发者感到困惑。如果您希望 GitHub 上不再留有任何存储库副本，您需要与派生所有者协作，分别删除他们的副本。删除父存储库时，无法自动同时删除所有派生。
检查协作者
在删除前，请始终检查谁可以访问您的存储库。
操作路径：前往 Settings > Collaborators（协作者），查看所有拥有访问权限的人员：
图片 8 - 具有存储库访问权限的人员
考虑主动联系活跃协作者，告知您的决定。请记住，一旦存储库被删除，这些 协作者将立即失去对项目的访问权限。
在删除共享存储库前提前告知协作者，是一种职业礼节。这样可以给他们时间在需要时克隆代码，或保存他们正在使用的重要信息。
克隆存储库
如果您预计将来可能需要存储库中的任何内容，请在删除前在本地进行克隆：
git clone https://github.com/yourusername/your-repository.git克隆存储库后，您将获得：
- 所有源代码。
- 完整的提交历史。
- 所有分支。
- 所有标签。
但是，克隆不会保留：
- Issue。
- Pull Request。
- Wiki 页面。
- GitHub 特有功能，如 Actions 工作流。
如果您需要保留这些附加元素，考虑使用 GitHub 的 API 进行备份，或寻找用于归档 GitHub 存储库的第三方工具。即使您认为再也用不到这些代码，有备无患总好过临时抱佛脚。
请记住，即便您在本地保存了代码，删除 GitHub 存储库意味着失去公开 URL、任何 GitHub Pages 部署，以及 GitHub 提供的协作功能。在继续删除之前，请确保您真的准备好放弃这些功能。
故障排查与常见问题
即使 GitHub 的删除流程很简单，您偶尔也可能遇到意外问题。本节将带您了解用户在尝试删除存储库时最常见的一些挑战。
>了解如何使用 git reset 命令 来管理项目历史。
无法删除存储库
如果您按步骤操作但仍无法删除存储库，可能的原因包括：
- 权限不足： 确认您对该存储库拥有管理员权限。只有存储库所有者和组织管理员才能删除存储库。
- 组织限制： 某些组织实施了防护策略，禁止删除存储库。若受限，请联系您的组织管理员。
- 正在运行的 GitHub Actions： 若有活跃的 Actions 工作流运行中，您可能需要先取消它们。前往 Actions 选项卡，取消所有进行中的工作流。
- GitHub 应用或 OAuth 集成： 某些第三方集成可能阻止删除。尝试临时禁用与存储库连接的 GitHub Apps 或 OAuth 应用。
- 浏览器问题： 清除浏览器缓存或尝试使用其他浏览器。有时缓存数据会干扰 GitHub 操作。
如果在删除过程中遇到错误消息，请记录下具体提示内容。这通常能提供阻碍删除的线索，答案往往只需一次 Google 搜索即可找到。
如果问题持续存在，GitHub 支持团队可以帮助识别组织层面的限制或账户相关的问题。
意外删除后的补救
我已经强调过，还要再强调一次：GitHub 无法恢复已删除的存储库。这一永久删除在 GitHub 文档和删除流程的确认对话框中都有明确说明。
如果您不慎删除了存储库，可选项十分有限：
- 检查本地克隆： 如果您或团队成员拥有该存储库的最新本地克隆，可将其推送到新的 GitHub 存储库，从而保留代码和提交历史。
- 派生的存储库： 如果有人在删除前 fork 了您的存储库，您也许可以从他们那里获得一份副本，但可能不包含最新更改。
- GitHub Enterprise 客户： 如果您使用的是 GitHub Enterprise，管理员可能拥有普通 GitHub 用户无法使用的备份选项。
为防止未来再出问题，我强烈建议实施以下预防措施：
- 定期备份： 设置自动脚本，定期克隆并备份重要存储库。
- 优先归档而非删除： 在可行情况下，优先选择将存储库归档为只读状态，而不是直接删除。
- 记录您的存储库： 维护重要存储库清单，包含描述及保留理由，便于在删除决策时更为理性。
很遗憾，GitHub 没有“回收站”功能，因此删除操作应始终谨慎对待。如有不确定，优先选择归档而非删除，为将来留出更多余地。
删除存储库后的最佳实践
成功删除存储库后，不妨借此机会对您的 GitHub 形象做一次全面梳理。
删除存储库不应是孤立的行为，而应成为保持 GitHub 主页整洁策略的一部分。下面分享在删除存储库后可考虑的一些最佳实践。
清理您的 GitHub 个人主页
删除存储库往往只是更全面清理流程的第一步。
您应定期执行以下操作：
- 审计剩余存储库： 审查所有存储库，识别那些已过时、冗余或与您当前工作与兴趣不再相关的项目。
- 更新存储库描述： 对保留的存储库，确保其描述与 README 保持最新，并清晰说明项目的目的与状态。
- 置顶最佳作品： 使用 GitHub 的置顶功能，在个人主页顶部突出展示最出色或最具代表性的项目。
- 用主题组织： 为存储库添加相关主题（topics），提升可发现性，并展示它们与您整体作品之间的关联。
简言之，完成这些步骤会让您的 GitHub 主页更专业，更准确地展现您当前的技能与兴趣。
相比拥有数十个被弃用或半成品项目，一个维护良好且包含 5-10 个高质量存储库的 GitHub 主页往往更能留下好印象。
审查存储库权限
删除存储库也是审查整个 GitHub 账户权限的好时机：
- 审计协作者访问： 检查谁能访问您保留的存储库，移除不再需要访问权限的协作者。
- 检查组织成员身份： 如果您属于某些组织，请确保您的角色与访问级别合适。
- 检查第三方集成： 审查并精简对您存储库有访问权限的 GitHub Apps、OAuth 应用或 Webhook。
- 更新默认存储库设置： 如果您常常创建新存储库，请更新默认设置，以便从您偏好的可见性与协作设置开始。
这种定期的安全审计有助于防止不必要的代码访问，并降低潜在安全风险。尤其当被删除的存储库包含敏感信息，或属于一个具有共享访问的更大项目时，此举尤为重要。
删除前先归档
对于未来的存储库清理，建议优先考虑归档，而非立刻删除。
归档会将存储库设为只读，阻止新的提交、Issue 或 Pull Request，同时保留所有现有内容并保持可访问。
对于已完成但可能需要日后参考的项目、希望展示但不再持续开发的项目，或暂时搁置的项目，您都应选择归档。
总之，归档在保持存储库活跃与永久删除之间提供了一个折中方案。对我而言，这对客户项目或课程作业很有用——无需持续维护，却可偶尔参考。
删除 GitHub 存储库的总结
您的 GitHub 主页不应成为“沼泽地”。删除陈旧且未使用的存储库，是展示专业形象并突出最佳作品的好方法。
本文带您完整了解了存储库删除流程——从删除后的影响，到逐步操作指引、删除前的重要考量、常见问题的排查，以及删除后的最佳实践。
您已经了解了永久删除存储库的全部内容、考虑对派生与协作者影响的重要性，以及在移除前创建备份的必要性。
我还分享了删除问题的实用排查建议、意外删除后的应对策略，以及通过定期审计与策略性归档来保持 GitHub 主页整洁与安全的建议。
如果您想进一步了解 Git 和 GitHub，以下来自 DataCamp 的课程是很好的起点：
删除 GitHub 存储库后，派生（fork）会怎样？
删除后 GitHub 能恢复我的存储库吗？
无法删除存储库时我该怎么办？
我应该归档还是删除旧的 GitHub 存储库？
删除共享存储库前，如何通知协作者？
主题