windows系统,怎么应用git命令创建仓库,克隆仓库,推送仓库。等等的全套新手教程
Windows 系统 Git 新手全套教程(使用 SSH 协议版)
本教程针对 Windows 系统,使用 Git 命令行(Git ),全程采用 SSH 协议 进行克隆、拉取和推送。SSH 的最大优势是配置好后无需每次输入用户名/密码或 Token,推送更方便安全。
1. 安装 Git for Windows
- 官网下载: https://git-scm.com/download/win
- 安装时一路 Next,推荐选项:
- 启用 “Git Here”
- 编辑器可选 VS Code 或其他
- 安装完成后,任意文件夹右键 → “Git Here” 打开终端。
2. 初次配置 Git(全局设置)
打开 Git ,设置身份(只需一次):
git config --global user.name "你的名字" # 如:Zhang San
git config --global user.email "你的邮箱@example.com"
可选:启用颜色输出,更好看
git config --global color.ui auto
检查配置:
git config --list
3. 生成并配置 SSH 密钥(核心步骤,必须做)
SSH 需要一对密钥:私钥留在本地,公钥上传到 GitHub。
- 生成密钥对(推荐 Ed25519 算法,更安全):
ssh-keygen -t ed25519 -C "你的邮箱@example.com"
- 按 Enter 接受默认路径(~/.ssh/id_ed25519)
- 密码(passphrase)可以为空(方便,但稍不安全),或设置一个复杂密码
- 生成后会有 id_ed25519(私钥)和 id_ed25519.pub(公钥)
如果你的系统不支持 Ed25519,可用 RSA:
ssh-keygen -t rsa -b 4096 -C "你的邮箱@example.com"
- 启动 SSH Agent(让 Git 使用密钥):
eval "$(ssh-agent -s)" # 启动 agent
ssh-add ~/.ssh/id_ed25519 # 添加私钥(如果设置了 passphrase 会提示输入)
建议把这几行加到 ~/.rc 里,以后自动执行:
echo 'eval "$(ssh-agent -s)"' >> ~/.rc
echo 'ssh-add ~/.ssh/id_ed25519' >> ~/.rc
- 将公钥添加到 GitHub:
- 查看公钥内容:
cat ~/.ssh/id_ed25519.pub
- 复制全部内容(以 ssh-ed25519 开头)
- 登录 GitHub → Settings → SSH and GPG keys → New SSH key
- Title 随便填,Key 类型选 Authentication Key
- 粘贴公钥 → Add SSH key
- 测试 SSH 连接:
ssh -T git@github.com
- 第一次会提示确认主机指纹,输入 yes
- 成功会显示:Hi username! You’ve successfully authenticated…
现在 SSH 配置完成,以后推送无需密码。
4. 创建本地仓库并推送到远程(以 GitHub 为例)
- 创建项目文件夹:
mkdir myproject
cd myproject
- 初始化仓库:
git init
- 添加文件(示例):
echo "# My Project" > README.md
echo 'print("Hello Git")' > main.py
- 提交:
git add .
git commit -m "首次提交:初始化项目"
- 在 GitHub 创建空仓库:
- New repository → 仓库名 myproject
- 不要 初始化 README(本地已有)
- 添加远程仓库(使用 SSH URL):
- GitHub 仓库页面会显示 SSH 地址: git@github.com:你的用户名/myproject.git
git remote add origin git@github.com:你的用户名/myproject.git
- 重命名分支为 main(GitHub 默认):
git branch -M main
- 推送(第一次设置上游):
git push -u origin main
- 如果 SSH 配置正确,会直接推送成功
以后修改后:
git add .
git commit -m "更新说明"
git push # 直接推送,无需认证
5. 克隆(下载)已有远程仓库(用 SSH)
如果你有仓库权限,直接用 SSH 地址克隆:
git clone git@github.com:别人用户名/仓库名.git
# 示例:git clone git@github.com:torvalds/linux.git
克隆后自动进入文件夹,远程已设置为 origin,以后 pull/push 直接用:
git pull # 拉取最新
git push
6. 日常完整操作流程(修改代码后)
- 查看状态:
git status
- 添加改动:
git add . # 所有文件
# 或 git add 具体文件
- 提交:
git commit -m "清晰的提交信息"
- 先拉取远程最新(避免冲突):
git pull --rebase # 推荐,线性历史更干净
# 或普通:git pull
- 推送:
git push
7. 其他常用命令
- 查看远程:
git remote -v # 显示 origin 的 SSH URL
- 切换/创建分支:
git switch -c newbranch # 创建并切换
git push -u origin newbranch # 推送新分支
- 查看历史:
git log --oneline --graph
- 解决冲突:pull 时冲突 → 编辑文件解决 → git add. → git commit
- 切换回 HTTPS(如果需要):
git remote set-url origin https://github.com/用户名/仓库名.git
8. 常见问题排查
- “Permission denied (publickey)” → SSH 密钥没添加正确,或 agent 没加载私钥(重启 Git 试 ssh-add)
- “ssh: connect to host github.com port 22: Connection timed out” → 网络问题,或国内需配置代理(搜索 Git SSH 代理)
- Windows 特殊:如果多个 SSH 密钥,可编辑 ~/.ssh/config 指定
- 推荐工具:GitHub Desktop(支持 SSH),或 VS Code Git 扩展
完成以上步骤,你就完全掌握了基于 SSH 的 Git 操作:创建、克隆、拉取、推送全流程。SSH 配置一次,以后操作最顺手!