如何仅推送单个文件至GitHub？是否需创建新分支？

别急，你完全不需要新建分支就能实现这个需求——问题出在你可能误解了Git推送的核心逻辑，我来帮你理清楚：

先搞懂Git推送的本质 #

Git推送的不是「单个文件」，而是整个提交（commit）对应的历史快照。但如果你的提交只包含某一个文件的变更，那推送时Git只会传输这个文件的更新数据（不是所有文件的完整副本）。你觉得“所有文件都被传输”，大概率是因为这些文件本来就已经在远程仓库里了——之前你可能用git add .之类的命令把所有文件都提交过，所以远程仓库里早就有它们了，这次推送只是更新了你修改的那个文件而已。

正确推送单个文件变更的步骤 #

只要确保你的提交只包含目标文件的变更，推送就只会处理这个文件：

• 只添加目标文件到暂存区：

  git add path/to/your/target-file.ext
  

  千万不要用git add .或git add *，不然会把所有变更的文件都加进去。
• 提交这个单独的变更：

  git commit -m "更新[目标文件名]：这里写具体的修改描述"
  

• 推送到远程仓库：

  git push origin master  # 如果你用的是main分支就改成main
  

  这时候Git只会把这个包含单个文件变更的提交推送到远程，远程仓库里的其他文件不会有任何变化，也不会被重复传输。

如果你的目标是让远程仓库只保留这一个文件 #

要是你想让远程仓库里只有这一个文件（而不是保留之前提交的其他文件），那需要额外做两步：

• 先移除本地其他文件的Git跟踪（但不会删除本地的文件）：

  # 单个移除
  git rm --cached other-file1.ext other-file2.ext
  # 批量移除所有文件，之后再重新添加目标文件
  git rm --cached .
  git add path/to/your/target-file.ext
  

• 提交这个“移除跟踪”的变更：

  git commit -m "清理仓库，仅保留目标文件"
  

• 推送后，远程仓库就只剩下你指定的那个文件了。

你之前操作无效的可能原因 #

• 你之前已经用git add .把所有文件都提交并推送到远程过了，所以远程仓库里本来就有这些文件，之后的推送只是更新单个文件，但仓库里依然会显示所有文件（因为它们本来就在那）。
• 你可能不小心把其他变更的文件也add并commit了，导致推送时包含了多个文件的变更。

内容的提问来源于stack exchange，提问作者Mr Miyagi