Git + Node.js 安装配置 + GitHub SSH 绑定完整教程

一、前置说明

• 适用系统：Windows
• 核心目标：完成 Git 安装配置、Node.js 多版本管理、GitHub SSH 免密绑定，满足日常开发需求
• 最终效果：本地 Git 与 GitHub 免密关联，可正常克隆/提交/推送代码；Node.js 支持多版本切换

二、第一部分：Git 安装与基础配置

1. Git 下载

• 官方地址（自动识别 64 位）：https://git-scm.com/download/win
• 镜像地址（官网慢时用）：https://registry.npmmirror.com/binary.html?path=git-for-windows/

2. Git 安装步骤

1. 双击下载的 .exe 安装包，一路点击 Next
2. 关键步骤：PATH 环境 选择第二项：Git from the command line and also from 3rd-party software（确保全局可调用 Git）
3. 其余选项默认，点击 Install 直至 Finish 完成安装

3. Git 安装验证

打开 CMD 或 Git Bash，输入以下命令，输出版本号即成功：

git --version
# 示例输出：git version 2.47.1（版本号以实际为准）

4. Git 全局配置（用户名/邮箱）

4.1 配置目的

记录代码提交者身份，与 GitHub 关联时确保提交记录正常显示。

4.2 配置命令

# 用户名（可自定义，建议与 GitHub 昵称关联）
git config --global user.name "你的用户名"
# 邮箱（建议与 GitHub 注册邮箱一致）
git config --global user.email "你的邮箱"

4.3 实际操作命令（示例）

git config --global user.name "zzc"
git config --global user.email "1572244090@qq.com"

4.4 配置验证

输入以下命令，查看输出是否包含配置的用户名和邮箱：

git config --global --list
# 成功输出示例：
# user.email=1572244090@qq.com
# user.name=zzc

三、第二部分：Node.js 多版本安装（nvm 管理）

1. 安装 nvm（Node 版本管理器）

1.1 下载 nvm-windows

地址：https://github.com/coreybutler/nvm-windows/releases，下载 nvm-setup.exe

1.2 nvm 安装步骤

1. 双击 nvm-setup.exe，一路默认 Next 安装
2. 安装完成后，重启 CMD/Git Bash（确保环境变量生效）

1.3 nvm 安装验证

输入以下命令，输出版本号即成功：

nvm version
# 示例输出：1.1.11（版本号以实际为准）

2. 用 nvm 安装 Node.js

2.1 查看可安装的 Node 版本

nvm list available

2.2 安装常用 LTS 版本（推荐 18/20 版本）

# 安装 18 版本
nvm install 18
# 安装 20 版本
nvm install 20

2.3 查看已安装 Node 版本

nvm list
# 输出示例：
# 20.15.0
# 18.20.3
# * 18.20.3 (Currently using 64-bit executable)

2.4 切换 Node 版本

# 切换到 18 版本
nvm use 18
# 切换到 20 版本
nvm use 20

2.5 Node/npm 验证

切换版本后，输入以下命令验证是否生效：

# 查看 Node 版本
node -v
# 示例输出：v18.20.3
# 查看 npm 版本（Node 自带）
npm -v
# 示例输出：10.7.0

3. nvm 常用命令（后续管理用）

四、第三部分：GitHub SSH 免密绑定（核心步骤）

1. 生成 SSH 密钥

打开 Git Bash，输入以下命令（替换为你的 GitHub 注册邮箱）：

ssh-keygen -t ed25519 -C "1572244090@qq.com"

• 执行后连续按 3 次回车（无需设置密码，直接生成密钥）

2. 找到并复制公钥

1. 打开电脑路径：C:\Users\你的Windows用户名\.ssh（如 C:\Users\ling\.ssh）
2. 用记事本打开文件 id_ed25519.pub
3. 复制文件内完整的字符串（不要遗漏、不要修改任何字符）

3. 在 GitHub 添加公钥

1. 登录 GitHub 账号，点击右上角头像 → Settings
2. 左侧菜单找到 SSH and GPG keys → 点击 New SSH key

3. 填写信息：

   • Title：自定义（如 我的电脑-工作机）
   • Key type：选择 SSH key
   • Key：粘贴刚才复制的公钥字符串
4. 点击 Add key 完成添加

4. 验证 SSH 绑定是否成功

在 Git Bash 输入以下命令：

ssh -T git@github.com

4.1 首次连接验证

会出现以下提示，输入 yes 并回车：

The authenticity of host 'github.com (20.205.243.166)' can't be established.
ED25519 key fingerprint is: SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes

4.2 成功标志

出现以下提示，说明绑定成功：

Warning: Permanently added 'github.com' (ED25519) to the list of known hosts.
Hi 1572244090! You've successfully authenticated, but GitHub does not provide shell access.

注：GitHub does not provide shell access 是正常提示，不影响代码操作。

五、关键验证与后续使用

1. 完整环境验证

确保以下命令均能正常输出：

# Git 版本
git --version
# Node 版本
node -v
# npm 版本
npm -v
# Git 全局配置
git config --global --list
# SSH 绑定验证
ssh -T git@github.com

2. 后续常用操作

2.1 Git 操作（GitHub 相关）

• 克隆 SSH 地址仓库：git clone git@github.com:用户名/仓库名.git
• 提交代码：git add . → git commit -m "提交说明" → git push（无需输密码）

2.2 Node 版本切换

• 查看已装版本：nvm list
• 切换版本：nvm use 版本号（如 nvm use 20）

3. 常见问题解决

3.1 Git 配置错误修改

直接重新执行配置命令覆盖即可：

git config --global user.name "新用户名"
git config --global user.email "新邮箱"

3.2 Node 切换版本失败

• 确保以管理员身份运行 CMD/Git Bash
• 重启终端后重新执行 nvm use 版本号

3.3 SSH 连接失败

• 检查公钥是否完整复制（无多余空格/换行）
• 检查 GitHub 邮箱与生成密钥时的邮箱一致
• 重新生成密钥并重新添加到 GitHub