在 Windows 系统上安装 Git 时，新手常会遇到一些典型问题，你遇到过几个？如果对你有用，请记得点赞关注收藏哦。

---

1. 安装路径含空格或特殊字符（如 Program Files）

坑点

默认安装路径是 C:\Program Files\Git，但某些工具或脚本可能无法正确处理带空格的路径，导致命令失效。

解决方案

自定义安装路径，使用全英文且无空格的目录（如 D:\DevTools\Git）。

操作示例

在安装向导的 “Select Destination Location” 界面，手动修改路径：

D:\DevTools\Git

（避免使用 C:\Program Files 或含中文的路径）

---

2. 未正确配置 Git Bash 终端（换行符问题）

坑点

Windows（CRLF）和 Linux/Mac（LF）换行符不同，可能导致代码提交后文件显示异常（如所有行合并成一行）。

解决方案

安装时选择 Checkout as-is, commit as-is（推荐开发者跨平台协作）。

操作示例

在 “Configuring the line ending conversions” 界面选择：

Checkout as-is, commit as-is

（避免使用默认的 Checkout Windows-style, commit Unix-style）

---

3. 环境变量未正确配置（git 命令不可用）

坑点

安装后，在 CMD/PowerShell 输入 git --version 提示 “不是内部或外部命令”，说明 Git 未加入系统 PATH。

解决方案

安装时勾选 “Add Git to the system PATH”（或手动添加环境变量）。

操作示例

在 “Adjusting your PATH environment” 界面选择：

Git from the command line and also from 3rd-party software

（确保 Git 可在任意终端使用）

---

4. SSH 密钥配置失败（Permission denied (publickey)）

坑点

使用 git clone git@github:user/repo.git 时提示权限错误，说明 SSH 密钥未正确配置。

解决方案

生成 SSH 密钥并添加到 GitHub/GitLab。

操作示例

# 1. 生成 SSH 密钥（默认路径 `~/.ssh/id_rsa`）
ssh-keygen -t rsa -b 4096 -C "your_email@example"

# 2. 启动 SSH 代理（确保密钥被加载）
eval $(ssh-agent -s)
ssh-add ~/.ssh/id_rsa

# 3. 复制公钥内容（Windows 可用 `clip`）
cat ~/.ssh/id_rsa.pub | clip

# 4. 粘贴到 GitHub → Settings → SSH and GPG keys

（测试连接：ssh -T git@github，应返回成功提示）

---

5. 默认编辑器是 Vim，新手不会保存退出

坑点

提交时自动打开 Vim，新手不知道如何保存（:wq）或退出（:q!），导致卡住。

解决方案

修改 Git 默认编辑器为 VSCode 或 Notepad++。

操作示例

# 设置为 VSCode
git config --global core.editor "code --wait"

# 或设置为 Notepad++
git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -multiInst -nosession"

（提交时 Git 会调用你熟悉的编辑器）

---

6. 代理配置问题（无法连接 GitHub）

坑点

公司网络或网络环境导致 git clone 失败（如 Failed to connect to github）。

解决方案

通过配置 Git 代理解决网络访问问题。

操作示例

# 1. 设置 HTTP 代理（替换端口）
git config --global http.proxy http://127.0.0.1:[端口号]

# 2. 设置 HTTPS 代理
git config --global https.proxy http://127.0.0.1:[端口号]

# 3. 取消代理（如不需要）
git config --global --unset http.proxy
git config --global --unset https.proxy

注：代理配置仅适用于企业内网等合法授权场景，请遵守当地网络法规。

---

7. 用户信息未配置（首次提交报错）

坑点

首次提交时报错：

*** Please tell me who you are.
Run:
  git config --global user.email "you@example"
  git config --global user.name "Your Name"

解决方案

全局配置用户名和邮箱。

操作示例

git config --global user.name "Your Name"
git config --global user.email "your_email@example"

（检查配置：git config --list）

---

8. Git Bash 中文乱码

坑点

git status 或 ls 显示中文文件名乱码（如 文件）。

解决方案

修改 Git Bash 编码为 UTF-8。

操作示例

在 Git Bash 窗口右键 → Options → Text → 选择 Locale: zh_CN, Character set: UTF-8。

或运行命令：

git config --global core.quotepath false  # 避免路径转义
export LANG="zh_CN.UTF-8"  # 临时生效

---

总结：Windows 安装 Git 避坑指南

1. 安装路径 → 无空格、无中文（如 D:\DevTools\Git）
2. 换行符 → 选 Checkout as-is, commit as-is
3. 环境变量 → 勾选 Add Git to PATH
4. SSH 密钥 → ssh-keygen + 添加到 GitHub
5. 默认编辑器 → 改成 VSCode/Notepad++
6. 代理问题 → 配置 http.proxy 或关闭
7. 用户信息 → 提前设置 user.name 和 user.email
8. 中文乱码 → 修改 Git Bash 编码为 UTF-8

安装完成后，运行 git --version 和 git config --list 检查是否正常。