Windows系统Git安装与基础设置指南

Git 是我们开发者作为版本就控制常用的工具，更是对接 GitHub 等平台的核心工具，为开发者提供代码管理、团队协作的便捷支持。本文将详细拆解 Windows 系统中 Git 的完整安装步骤、验证方法、基础配置及常用操作，清晰标注关键流程与注意事项，帮助新手快速上手，顺利完成 Git 安装与环境搭建，为后续代码管理和 GitHub 绑定做好准备。

以下是 Windows 系统下 Git 的详细安装步骤和基础设置指南：

一、详细安装步骤

1. 下载 Git 安装包

• 访问 Git 官网，点击页面上的 Download for Windows。
• 根据系统版本（10/11）下载最新安装包（文件名类似 Git-xxx-64-bit.exe）。

2. 运行安装程序

1. 双击安装包，按以下选项配置：

• Component Selection：
  勾选 Git for Windows 和 Git Bash Here（推荐保留，默认会安装常用工具）。
• Path：
  保持默认路径（C:\Program Files\Git），避免空格或特殊字符导致的问题。
• Git Bash Terminal：
  勾选 Use the system’s default console window（推荐使用 PowerShell 或 CMD 会更灵活）。
• Line ending conversion：
  选择 Checkout as-is, commit with CRLF（国内用户推荐，避免换行符问题）。
• Terminal emulator：
  保持默认的 Git Bash。
• SSH executable：
  选择 Git’s built-in ssh.exe。
• Other options：
  勾选 Add Git to PATH（关键步骤，否则命令行无法识别 git）。

2. 点击 Install 完成安装。

二、验证安装

1. 打开 PowerShell 或 CMD：

按 Win + R 输入 cmd 或 powershell，按回车。

2. 检查 Git 版本：

输入以下命令，确认输出版本号：

git --version

如果显示版本信息（如 git version 2.40.1），表示安装成功。

三、基础配置

1. 设置全局用户名和邮箱

git config --global user.name "你的真实姓名"    # 用于提交记录的作者名
git config --global user.email "你的邮箱@example.com"  # 绑定 GitHub 等平台账号

2. 生成 SSH 密钥（绑定 GitHub）

1. 打开 Git Bash：

按 Win + R 输入 gitbash，按回车。

2. 生成密钥：

ssh-keygen -t ed25519 -C "你的邮箱@example.com"

• 按回车接受默认路径（~/.ssh/id_ed25519）。
• 提示输入密码时直接连续按两次回车（不设置密码短语）。

3. 复制公钥到剪贴板：

cat ~/.ssh/id_ed25519.pub | clip

4. 粘贴公钥内容并保存

登录 GitHub，进入 Settings > SSH and GPG keys，点击 New SSH key，粘贴公钥内容并保存。

四、配置环境变量（可选）

如果安装时未勾选 Add Git to PATH，需手动配置：

1. 右键点击 此电脑 > 属性 > 高级系统设置 > 环境变量。
2. 在 系统变量 中找到 Path，点击 编辑。
3. 添加 Git 安装路径下的 bin 目录（如 C:\Program Files\Git\bin）。
4. 点击确定保存。

五、常用命令演示

1. 克隆仓库

git clone https://github.com/用户名/仓库名.git

2. 提交代码

// 进入项目目录
cd 仓库名

// 添加文件到暂存区
git add <文件名/相对路径/绝对路径>      # 添加单个文件
git add .  # 添加全部文件 git add *    

// 提交并附加说明
git commit -m "Initial commit"

// 关联远程仓库（首次推送）
git remote add origin https://github.com/用户名/仓库名.git

// 推送代码到主分支
git push -u origin main

3. 拉取远程更新

git pull origin main

六、常见问题解决

1. 提交时提示身份验证失败

• 确保已绑定 SSH 密钥，或在 HTTPS 协议下输入 GitHub 账号的密码。
• 若使用 SSH，检查密钥权限：

  chmod 600 ~/.ssh/id_ed25519
  

2. Git Bash 中中文乱码

修改终端编码：

export LANG=en_US.UTF-8
export LC_CTYPE=en_US.UTF-8

或将系统语言设置为 UTF-8。

3. 路径过长报错

启用 Git 的长路径支持（需管理员权限）：

git config --global core.longpaths true

七、推荐工具

1. 图形化客户端：

• Sourcetree（免费）
• GitHub Desktop

2. 编辑器集成：

• VS Code、Sublime Text 等支持 Git 插件。

完成以上步骤后，你就可以熟练使用 Git 进行版本控制了！

以上就是 Windows 系统 Git 的安装、验证、基础配置及常见问题解决指南，重点掌握安装配置、SSH 密钥绑定、常用命令核心要点，即可应对日常版本控制需求。

以上关于Windows系统Git安装与基础设置指南的文章就介绍到这了，更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章，希望大家以后多多支持码云笔记。