windows系统,怎么应用git命令创建仓库,克隆仓库,推送仓库。等等的全套新手教程

Windows 系统 Git 新手全套教程(使用 SSH 协议版)

本教程针对 Windows 系统,使用 Git 命令行(Git ),全程采用 SSH 协议 进行克隆、拉取和推送。SSH 的最大优势是配置好后无需每次输入用户名/密码或 Token,推送更方便安全。

1. 安装 Git for Windows

  1. 官网下载: https://git-scm.com/download/win
  2. 安装时一路 Next,推荐选项:
    • 启用 “Git Here”
    • 编辑器可选 VS Code 或其他
  3. 安装完成后,任意文件夹右键 → “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。

  1. 生成密钥对(推荐 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"
  1. 启动 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
  1. 将公钥添加到 GitHub:
    • 查看公钥内容:
cat ~/.ssh/id_ed25519.pub
  • 复制全部内容(以 ssh-ed25519 开头)
  • 登录 GitHub → Settings → SSH and GPG keys → New SSH key
  • Title 随便填,Key 类型选 Authentication Key
  • 粘贴公钥 → Add SSH key
  1. 测试 SSH 连接:
ssh -T git@github.com
  • 第一次会提示确认主机指纹,输入 yes
  • 成功会显示:Hi username! You’ve successfully authenticated…

现在 SSH 配置完成,以后推送无需密码。

4. 创建本地仓库并推送到远程(以 GitHub 为例)

  1. 创建项目文件夹:
mkdir myproject

cd myproject
  1. 初始化仓库:
git init
  1. 添加文件(示例):
echo "# My Project" > README.md

echo 'print("Hello Git")' > main.py
  1. 提交:
git add .

git commit -m "首次提交:初始化项目"
  1. 在 GitHub 创建空仓库:
    • New repository → 仓库名 myproject
    • 不要 初始化 README(本地已有)
  2. 添加远程仓库(使用 SSH URL):
    • GitHub 仓库页面会显示 SSH 地址: git@github.com:你的用户名/myproject.git
git remote add origin git@github.com:你的用户名/myproject.git
  1. 重命名分支为 main(GitHub 默认):
git branch -M main
  1. 推送(第一次设置上游):
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. 日常完整操作流程(修改代码后)

  1. 查看状态:
git status
  1. 添加改动:
git add .                # 所有文件

# 或 git add 具体文件
  1. 提交:
git commit -m "清晰的提交信息"
  1. 先拉取远程最新(避免冲突):
git pull --rebase        # 推荐,线性历史更干净

# 或普通:git pull
  1. 推送:
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 配置一次,以后操作最顺手!

登录

注册

重设密码

请输入您的用户名或电子邮箱地址。您会收到一封包含创建新密码链接的电子邮件。