如何解决GitHub上单文件推送被拒、无法覆盖远程对应文件的问题

该报错本质是远程main分支存在本地没有的提交内容，Git为了避免强制覆盖远程更新，直接拒绝了推送请求。
原始报错翻译：

! [rejected]        main -> main (fetch first)
error: failed to push some refs to 'https://github.com/abdulbadii/MatrixMultiplier'
hint: Updates were rejected because the remote contains work that you do
hint: not have locally. This is usually caused by another repository pushing
hint: to the same ref. You may want to first integrate the remote changes
hint: (e.g., 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details

翻译释义：

! [拒绝]        main -> main (请先拉取远程内容)
错误: 推送部分引用到 'https://github.com/abdulbadii/MatrixMultiplier' 失败
提示: 更新被拒绝，因为远程包含你本地不存在的提交内容。该问题通常是其他推送操作向同一个分支提交内容导致。你需要先合并远程的变更（比如执行 `git pull` 命令）再重新推送。
提示: 可查看 `git push --help` 中的 "关于快进的说明" 获取详情

方案1：仅替换指定单个文件（不影响远程其他文件变更，优先选择 #

适用于只需要更新目标单个文件，不需要改动远程其他文件的场景，操作最稳妥：

• 先将你需要推送的单个文件复制到仓库外的其他位置做好备份
• 拉取远程最新内容到本地合并：
  git pull origin main
• 用之前备份好的文件，覆盖本地仓库内对应路径的文件
• 提交单个文件变更：
  git add <替换的文件路径>
git commit -m "填写你的提交说明，比如修改xx文件计算逻辑"
• 执行推送：
  git push origin main

方案2：保留本地所有修改，合并远程变更后整体推送 #

适用于本地有多个修改需要保留，同时需要合并远程其他更新的场景：

• 拉取远程最新内容并通过变基合并，避免生成多余的合并提交：
  git pull origin main --rebase
• 若出现冲突，打开冲突文件手动编辑保留需要的内容，完成后执行：
  git add <冲突文件路径>
git rebase --continue
• 变基完成后执行推送：
  git push origin main

方案3：确认无需保留远程所有变更，直接用本地内容覆盖 #

此操作会清空远程所有本地不存在的提交，请确认后再操作：

• 执行强制推送：
  git push origin main --force

推送完成后访问GitHub对应仓库页面，查看目标文件的提交记录和内容，确认和你本地版本一致即可。

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