将本地已有的文件夹推送到远程 Git 仓库（如 GitHub、Gitee、GitLab 等）是一个非常常见的操作。以下是详细的图文级步骤：
第一阶段：在远程平台创建“空”仓库
- 登录你的代码托管平台（如 GitHub / Gitee）。
- 点击创建新仓库（New Repository）。
- 填写仓库名称（建议与本地文件夹同名）。
- ⚠️ 重要提示：不要勾选“Initialize this repository with a README”（不要初始化 README），也不要添加
.gitignore和 License。必须保证远程仓库是完全为空的，否则后续推送会报冲突错误。 - 创建完成后，复制仓库的 URL 地址（HTTPS 或 SSH 地址均可）。
第二阶段：本地命令行操作
打开你的终端（Terminal / CMD / Git Bash），依次执行以下命令：
1. 进入你的本地文件夹
cd /你的/本地/文件夹/路径
2. 初始化 Git 仓库
将该文件夹变成一个 Git 可管理的仓库：
git init
3. （强烈建议）配置 .gitignore 文件
在文件夹根目录新建一个名为 .gitignore 的文件，把不需要上传的依赖包、编译产物或配置文件写进去（例如 node_modules/、.idea/、.vscode/、target/ 等），避免把几 GB 的无用文件推送到远程。
4. 将文件添加到暂存区
将当前文件夹下的所有文件添加到 Git 的暂存区（注意 add 和 . 之间有一个空格）：
git add .
5. 提交文件到本地仓库
给这次提交写一句说明：
git commit -m "首次提交：初始化项目"
6. 重命名本地分支为 main
目前 GitHub 等主流平台默认的主分支名是 main（老版本 Git 默认是 master），为了保持一致，执行：
git branch -M main
7. 关联远程仓库
将第一阶段复制的远程仓库 URL 替换到下面的命令中（给远程仓库起个别名叫 origin）：
git remote add origin <你的远程仓库URL>
(示例：git remote add origin https://github.com/username/my-project.git)
8. 推送到远程仓库
将本地代码推送到远程仓库，并设置上游分支：
git push -u origin main
💡 常见问题与避坑指南
1. 提示 fatal: remote origin already exists
- 原因：你之前可能在这个文件夹里关联过其他的远程地址。
- 解决：先移除旧的关联，再重新添加。
git remote remove origin git remote add origin <新的URL>
2. 提示 rejected 或 non-fast-forward
- 原因：你的远程仓库不是空的（比如你创建时手滑勾选了初始化 README），导致远程和本地的提交历史不一致。
- 解决：如果远程仓库里没有任何重要代码，可以直接强制推送覆盖远程内容：
git push -f origin main
3. 推送时弹窗要求输入密码，但输入密码后提示错误
- 原因：GitHub 等平台已经废弃了账号密码登录，HTTPS 方式现在需要使用 Token（个人访问令牌）。
- 解决：
- 方法 A：去平台设置里生成一个 Personal Access Token (PAT)，在要求输入密码的地方，粘贴 Token 而不是你的登录密码。
- 方法 B（推荐）：改用 SSH 地址（
[email protected]:...），并在本地配置好 SSH Key，这样以后推送就再也不用输入密码了。
4. 推送后想更新代码怎么办？ 以后你在本地修改了代码，只需要执行经典的“三步曲”即可：
git add .
git commit -m "更新了xxx功能"
git push
转载自 CSDN-专业IT技术社区
原文链接：https://blog.csdn.net/yang1276/article/details/166592795
