你想通过 Git Bash 将 Windows 本地创建的仓库上传到 GitHub(包括私有仓库),核心流程和 CentOS 类似,但适配了 Windows 系统的操作细节,下面是一步步可直接跟着做的详细步骤,新手也能轻松搞定:
运行
bash
运行
运行
出现
运行
运行1. 报错
原因:本地分支是
bash
运行2. 报错
原因:已关联过其他远程仓库。解决:
bash
运行3. 报错
原因:SSH 密钥未配置成功。解决:
一、前置准备(Windows 端)
1. 确认已安装 Git Bash
如果没装,先下载安装:https://git-scm.com/download/win(安装时一路下一步即可,默认选项适配 Windows)。安装完成后,右键桌面 → 选择 Git Bash Here 打开终端。2. 配置 Git 用户名和邮箱(和 GitHub 一致)
bash运行
# 替换成你的 GitHub 用户名和注册邮箱
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"
# 验证配置(可选)
git config --list
3. 配置 SSH 密钥(免密上传,推荐)
和 CentOS 原理一致,只是 Windows 路径不同:bash
运行
# 生成 ed25519 密钥(替换为你的邮箱)
ssh-keygen -t ed25519 -C "你的GitHub邮箱@xxx.com"
- 回车后提示
Enter file in which to save the key:直接回车(默认保存到C:\Users\你的Windows用户名\.ssh\id_ed25519); - 提示
Enter passphrase:连续两次回车(空密码,免密上传)。
4. 复制公钥到 GitHub
- 打开密钥路径:
C:\Users\你的Windows用户名\.ssh\id_ed25519.pub(用记事本打开); - 复制文件里全部内容(以
ssh-ed25519开头,到邮箱结束); - 登录 GitHub → 头像 → Settings → SSH and GPG keys → New SSH key → 粘贴公钥 → Add SSH key。
5. 测试 SSH 连接(验证是否生效)
bash运行
ssh -T git@github.com
出现
Hi 你的用户名! You've successfully authenticated... 说明配置成功。
二、GitHub 端:创建仓库(私有 / 公开)
- 登录 GitHub → 右上角 + → New repository;
- 填写仓库名(如
win-project)→ 选择 Private(私有)→ 不勾选 README/.gitignore → Create repository; - 记录仓库 SSH 地址:
git@github.com:你的用户名/win-project.git。
三、Git Bash 上传本地仓库到 GitHub
场景 1:本地已有 Git 仓库(已执行过 git init)
bash运行
# 1. 进入本地仓库目录(替换为你的项目路径,比如桌面的 project 文件夹)
cd /c/Users/你的用户名/Desktop/project
# 2. 关联远程 GitHub 仓库(替换为你的 SSH 地址)
git remote add origin git@github.com:你的用户名/win-project.git
# 3. 拉取远程空仓库(避免分支冲突,可选)
git pull origin main --allow-unrelated-histories
# 4. 提交本地代码(如果有未提交的修改)
git add .
git commit -m "首次上传:Windows 本地项目"
# 5. 推送代码到 GitHub(首次推送加 -u 关联分支)
git push -u origin main
# 若提示分支是 master,执行:git push -u origin master
场景 2:本地是普通文件夹(未初始化 Git)
bash运行
# 1. 进入本地文件夹
cd /c/Users/你的用户名/Desktop/你的项目文件夹
# 2. 初始化 Git 仓库
git init
# 3. 添加并提交所有文件
git add .
git commit -m "初始化仓库并提交"
# 4. 关联远程仓库(替换为你的 SSH 地址)
git remote add origin git@github.com:你的用户名/win-project.git
# 5. 推送代码
git push -u origin main
四、常见问题解决
1. 报错 error: src refspec main does not match any
原因:本地分支是 master 或无提交记录。解决:bash
运行
# 有提交记录:推送 master 分支
git push -u origin master
# 无提交记录:先提交再推送
git add .
git commit -m "首次提交"
git push -u origin main
2. 报错 fatal: remote origin already exists
原因:已关联过其他远程仓库。解决:bash
运行
# 删除旧关联
git remote remove origin
# 重新添加正确的仓库地址
git remote add origin git@github.com:你的用户名/win-project.git
3. 报错 Permission denied (publickey)
原因:SSH 密钥未配置成功。解决:
- 检查公钥是否完整复制到 GitHub;
- 重新测试 SSH 连接:
ssh -T git@github.com; - 若仍失败,改用 HTTPS 地址推送(需输入 GitHub 用户名 + 个人访问令牌):
bash
运行git remote remove origin git remote add origin https://github.com/你的用户名/win-project.git git push -u origin main
总结
- 核心步骤:Windows 上传和 CentOS 一致,关键是配置 Git 账号 + SSH 密钥,关联远程仓库后推送;
- 路径注意:Git Bash 中 Windows 路径要写成
/c/Users/xxx/(而非C:\Users\xxx\); - 分支适配:Windows 下 Git 旧版本默认分支是
master,推送时对应替换即可。
声明:本文网友投稿,观点仅代表作者本人,不代表鲁班SEO赞同其观点或证实其描述。
