以下是 Windows 10/11 系统下 Git 的详细安装步骤和基础设置指南:
Windows 10/11 系统下 Git 的详细安装步骤和基础设置指南
- 一、详细安装步骤
- 1. 下载 Git 安装包
- 2. 运行安装程序
- 1. 双击安装包,按以下选项配置:
- 2. 点击 Install 完成安装。
- 二、验证安装
- 1. 打开 PowerShell 或 CMD:
- 2. 检查 Git 版本:
- 三、基础配置
- 1. 设置全局用户名和邮箱
- 2. 生成 SSH 密钥(绑定 GitHub)
- 1. 打开 Git Bash:
- 2. 生成密钥:
- 3. 复制公钥到剪贴板:
- 4. 粘贴公钥内容并保存
- 四、配置环境变量(可选)
- 五、常用命令演示
- 1. 克隆仓库
- 2. 提交代码
- 3. 拉取远程更新
- 六、常见问题解决
- 1. 提交时提示身份验证失败
- 2. Git Bash 中中文乱码
- 3. 路径过长报错
- 七、推荐工具
- 1. 图形化客户端:
- 2. 编辑器集成:
一、详细安装步骤
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,需手动配置:
- 右键点击 此电脑 > 属性 > 高级系统设置 > 环境变量。
- 在 系统变量 中找到
Path
,点击 编辑。 - 添加 Git 安装路径下的
bin
目录(如C:\Program Files\Git\bin
)。 - 点击确定保存。
五、常用命令演示
1. 克隆仓库
git clone https://github.com/用户名/仓库名.git
2. 提交代码
# 进入项目目录
cd 仓库名# 添加文件到暂存区
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 进行版本控制了!如果有具体问题,欢迎随时提问。