admin 管理员组文章数量: 1184232
在 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 避坑指南
- 安装路径 → 无空格、无中文（如
D:\DevTools\Git） - 换行符 → 选
Checkout as-is, commit as-is - 环境变量 → 勾选
Add Git to PATH - SSH 密钥 →
ssh-keygen+ 添加到 GitHub - 默认编辑器 → 改成 VSCode/Notepad++
- 代理问题 → 配置
http.proxy或关闭 - 用户信息 → 提前设置
user.name和user.email - 中文乱码 → 修改 Git Bash 编码为 UTF-8
安装完成后，运行 git --version 和 git config --list 检查是否正常。
版权声明：本文标题：Git实战系列之新手在windows安装git时，常遇到的坑，你遇到过几个？（附详细填坑教程） 内容由网友自发贡献，该文观点仅代表作者本人， 转载请联系作者并注明出处：http://www.roclinux.cn/b/1755554091a3074633.html， 本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容，一经查实，本站将立刻删除。
发表评论