GitHub 删除文件有四种方式：一、网页端删除，仅移除最新版本；二、Git 命令行 git rm 删除当前分支引用；三、git filter-repo 彻底清除历史记录；四、GitHub CLI 调用 API 删除，等效网页操作。
如果您需要从 GitHub 仓库中移除某个文件，但该文件已提交至版本历史，则不能仅通过网页端删除后就彻底清除其记录。以下是几种可行的删除方式，涵盖本地操作与远程同步的不同场景：
一、通过 GitHub 网页界面删除单个文件
此方法适用于未被频繁修改、且无需从历史提交中彻底抹除的文件。操作后文件将从最新分支的 HEAD 中消失，但 Git 历史中仍保留该文件的旧版本。
1、登录 GitHub 账户，进入目标仓库主页。
2、在文件列表中导航至要删除的文件，点击该文件名进入预览页。
3、点击右上角的 编辑（铅笔图标） 按钮。
4、在编辑页面顶部点击 Delete this file 链接。
5、在确认框中填写提交信息，勾选 Commit directly to the main branch 或选择新建分支，然后点击 Commit changes。
二、使用 Git 命令行从工作区和暂存区删除文件
此方法可确保文件从当前分支的下一次提交中移除，并支持批量处理。文件仍保留在 Git 历史中，但不再出现在工作目录和索引里。
1、在本地克隆仓库的目录中打开终端或命令行工具。
2、执行命令 git rm --cached ，例如 git rm --cached docs/README.md，以取消跟踪但保留本地文件；若需同时删除本地副本，则省略 --cached 参数。
3、运行 git commit -m "remove " 提交变更。
4、执行 git push origin 将删除操作推送到远程仓库。
三、彻底从 Git 历史中删除文件（含所有提交记录）
当文件曾误提交敏感内容（如密钥、大体积资源），需将其从所有历史快照中清除时，必须重写提交历史。该操作会影响协作成员的工作流，需谨慎执行。
1、确保本地仓库为最新状态，运行 git pull origin 。
2、安装并调用 git filter-repo 工具（需提前通过 pip 安装），执行命令：git filter-repo --path --invert-paths --force。
3、强制推送重写后的分支：git push origin --force --all 和 git push origin --force --tags。
4、通知所有协作者重新克隆仓库，因原有提交哈希已全部变更。
四、使用 GitHub CLI 删除文件
GitHub CLI（gh）提供更简化的命令式交互，适合熟悉终端操作的用户，其行为等效于网页界面的删除流程，不触及历史记录。
1、在终端中进入本地仓库目录，确保已通过 gh auth login 登录账户。
2、运行命令：gh repo view --web 确认当前仓库正确无误。
3、执行删除指令：gh api repos/{owner}/{repo}/contents/{file_path} -X DELETE -f message="remove file" -f sha=$(gh api repos/{owner}/{repo}/contents/{file_path} | jq -r .sha)，其中 {owner}、{repo}、{file_path} 需替换为实际值。
