Windows 11 上配置VSCode 使用 Git 和 SSH 完整步骤

在 Windows 11 上,通过 VSCode 使用 Git 和 SSH 克隆 GitHub 仓库的完整优化步骤如下:


1. 安装必备工具

  1. 下载并安装 Git:

    • 访问 Git 官网 下载最新版本。
    • 安装时,选择以下选项:
      • Default editor for Git: Use Visual Studio Code as Git's default editor
      • Adjust your PATH environment: Git from the command line and also from 3rd-party software
      • Configuring the line ending conversions: Checkout Windows-style, commit Unix-style line endings
  2. 下载并安装 VSCode:

  3. 检查 OpenSSH 是否启用:

    • 打开 控制面板 > 程序 > 程序和功能 > 启用或关闭 Windows 功能,确保 OpenSSH 客户端 已启用。

2. 配置 Git 和 SSH

  1. 设置 Git 的用户信息:

    打开命令提示符 (CMD) 或 PowerShell,输入以下命令:

    bash 复制代码
    git config --global user.name "Your Name"
    git config --global user.email "your_email@example.com"

    检查配置是否成功:

    bash 复制代码
    git config --global -l
  2. 生成 SSH 密钥:

    • 打开终端(PowerShell 或 CMD):

      bash 复制代码
      ssh-keygen -t ed25519 -C "your_email@example.com"

      如果不支持 ed25519,使用以下命令生成 rsa 密钥:

      bash 复制代码
      ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
    • 当提示保存路径时,按回车键保存到默认路径:

      复制代码
      C:\Users\YourUserName\.ssh\id_ed25519
    • 设置一个密码(建议安全性更高)。

  3. 启动 SSH 代理并添加密钥:

    打开终端,输入以下命令:

    bash 复制代码
    eval "$(ssh-agent -s)"
    ssh-add C:\Users\YourUserName\.ssh\id_ed25519
  4. 将 SSH 公钥添加到 GitHub:

    • 复制公钥:

      bash 复制代码
      type C:\Users\YourUserName\.ssh\id_ed25519.pub
    • 登录 GitHub:

      • 点击右上角头像 > Settings > SSH and GPG keys > New SSH key
      • 粘贴公钥内容,点击 Add SSH key
  5. 测试 SSH 连接:

    在终端中输入:

    bash 复制代码
    ssh -T git@github.com

    如果成功,返回:

    复制代码
    Hi username! You've successfully authenticated, but GitHub does not provide shell access.

3. 在 VSCode 中克隆 GitHub 仓库

  1. 获取 SSH URL:

    • 登录 GitHub,导航到目标仓库。
    • 点击绿色的 Code 按钮,选择 SSH ,复制 URL(形如 git@github.com:username/repo.git)。
  2. 在 VSCode 中克隆:

    • 打开 VSCode。
    • 按下 Ctrl+Shift+P(或 Cmd+Shift+P),搜索并选择 Git: Clone
    • 在输入框中粘贴仓库的 SSH URL。
    • 选择存储克隆文件的本地文件夹。
  3. 打开项目:

    • 克隆完成后,VSCode 会提示是否打开该项目。
    • 点击 Open,加载项目。

4. 提交和推送代码到 GitHub

  1. 在 VSCode 中修改代码:

    修改文件后,VSCode 的 Source Control 面板会显示变更。

  2. 提交更改:

    • 在终端中运行以下命令:

      bash 复制代码
      git add .
      git commit -m "Your commit message"
      git push
    • 或在 Source Control 面板中点击 + 添加所有更改,填写提交信息后点击 ✔️ Commit

  3. 推送到 GitHub:

    在终端运行:

    bash 复制代码
    git push

    或点击 Source Control 面板中的 Push 按钮。


5. 配置多账号或多个 SSH 密钥(可选)

如果需要配置多个 SSH 密钥(如公司和个人 GitHub 账号),需设置 ~/.ssh/config 文件:

  1. 编辑 C:\Users\YourUserName\.ssh\config 文件(如果不存在,创建一个)。

  2. 添加以下内容:

    plaintext 复制代码
    Host github-personal
        HostName github.com
        User git
        IdentityFile C:\Users\YourUserName\.ssh\id_ed25519_personal
    
    Host github-work
        HostName github.com
        User git
        IdentityFile C:\Users\YourUserName\.ssh\id_ed25519_work
  3. 使用指定配置克隆仓库:

    bash 复制代码
    git clone git@github-personal:username/repo.git

6. 常见问题及解决方法

  1. SSH 连接失败:

    • 检查 ~/.ssh 文件夹权限,确保仅当前用户有访问权限。
    • 验证 GitHub 公钥是否正确添加。
  2. VSCode 无法识别 Git:

    • 确保 Git 已正确安装。
    • 在 VSCode 中按 Ctrl+Shift+P,搜索并打开 Settings
    • 搜索 Git Path,手动设置为 C:\Program Files\Git\bin\git.exe
  3. 权限问题:

    • 如果出现 Permission denied,尝试重新添加密钥或切换到正确的配置。
相关推荐
kyle~39 分钟前
Windows---动态链接库Dynamic Link Library(.dll)
运维·windows·操作系统·运维开发·开发部署
i建模1 小时前
将远程 main 分支同步到 develop 分支的完整指南
git
中游鱼3 小时前
如何序列化和反序列化动态 XmlElement ?
windows·microsoft·c#
我命由我123458 小时前
Kotlin 数据容器 - List(List 概述、创建 List、List 核心特性、List 元素访问、List 遍历)
java·开发语言·jvm·windows·java-ee·kotlin·list
mCell10 小时前
从删库到跑路?这50个Linux命令能保你职业生涯
linux·windows·macos
dualven_in_csdn10 小时前
electron 使用记录
windows
即使再小的船也能远航11 小时前
【Git】实用Git操作指南:从入门到高效协作
git
zz96022612 小时前
Windows Server存储池,虚拟磁盘在系统启动后不自动连接需要手动连接
windows
吳所畏惧17 小时前
NVM踩坑实录:配置了npm的阿里云cdn之后,下载nodejs老版本(如:12.18.4)时,报404异常,下载失败的问题解决
前端·windows·阿里云·npm·node.js·batch命令
leese23317 小时前
FreeMarker模板引擎
windows