参考资料
- Git 安装避坑指南
- Layui 是一款轻量级的前端 UI 框架
- MySQL配置性能优化
- JavaScript性能优化实战
- PyCharm高效入门指南
- Markdown 说明
- marked是一个快速高效的Markdown解析器和编译器
- Git安装避坑指南
以下是一份超详细的 Git安装避坑指南,涵盖全平台(Windows/macOS/Linux)的核心配置、常见问题及底层原理,助你彻底避开安装陷阱:
一、安装前的关键决策
1. 官方渠道下载(严防捆绑软件)
- Windows:
- macOS:
- Linux:
- Ubuntu/Debian:
sudo apt update && sudo apt install git -y
- CentOS/RHEL:
sudo yum install git -y
2. 权限预处理
- Windows:临时禁用杀毒软件(如360/电脑管家),它们可能拦截SSH密钥生成
- macOS/Linux:确保有
sudo 权限
二、Windows 安装深度解析(90%的坑在这里)
步骤1:安装路径
- 致命陷阱:路径含中文或空格
❌ 错误示例:
D:\编程工具\Git
✅ 正确方案:C:\Program Files\Git(默认路径)
步骤2:组件选择(Components)
步骤3:选择默认编辑器(新手最大痛点)
- 避坑指南:
- 避免选
Vim(需掌握命令模式操作)
- 推荐选
Nano(简单命令行编辑器)
- 或用VS Code:安装时勾选 Add to PATH,此处选 Use Visual Studio Code
步骤4:PATH环境配置(最关键一步)
- 必须选择:
Git from the command line and also from 3rd-party software
- ✅ 作用:将
git.exe 所在路径(如 C:\Program Files\Git\cmd)加入系统 PATH
- ❌ 不选的后果:CMD/PowerShell 中无法识别
git 命令
步骤5:行尾换行符(跨平台协作核心)
- 科学选择:
系统选项底层配置Windows
Checkout Windows-style, commit Unix-stylecore.autocrlf=trueLinux/macOSCheckout as-is, commit Unix-stylecore.autocrlf=input - 原理:
Windows换行符为
CRLF(\r\n),Unix为 LF(\n)。此设置自动转换避免文件差异。
步骤6:终端模拟器
- 必选:
Use MinTTY
- 优势:支持复制粘贴(Ctrl+C/V)、调整字体、中文显示
- 替代方案:Windows Terminal(需单独安装)
三、macOS/Linux 特殊注意事项
1. macOS 证书问题
- # 安装时若提示证书错误:
- sudo installer -pkg /path/to/git.pkg -target /
2. Linux 旧版本升级
- # Ubuntu 官方ppa升级最新版
- sudo add-apt-repository ppa:git-core/ppa
- sudo apt update && sudo apt install git
四、安装后必做验证
1. 基础检查
- git --version # 应返回版本号(如 git version 2.41.0)
- which git # 查看安装路径(Linux/macOS)
- where git # Windows查看路径
2. 全局身份配置(避免后续提交失败)
- git config --global user.name "YourRealName"
- git config --global user.email "your_email@domain.com"
3. 中文支持(防乱码)
- # 解决中文路径显示为八进制
- git config --global core.quotepath off
- # 设置提交信息编码(UTF-8)
- git config --global i18n.commitencoding utf-8
五、高频问题解决方案
问题1:git: command not found
- Windows专属解法:
- 打开:
控制面板 > 系统 > 高级系统设置 > 环境变量
- 编辑
Path → 新增:C:\Program Files\Git\cmd
- 卸载重装,确保勾选 Add to PATH
- 手动添加PATH:
问题2:Permission denied (publickey)
- 密钥生成与配置:
- ssh-keygen -t ed25519 -C "your_email@domain.com" # 生成密钥
- cat ~/.ssh/id_rsa.pub # 复制公钥
将公钥粘贴到 GitHub 或 GitLab
问题3:warning: LF will be replaced by CRLF
- 终极解决方案:
- # 关闭换行符自动转换(适合纯Linux/macOS环境)
- git config --global core.autocrlf false
六、进阶优化配置
- # 启用终端颜色标记
- git config --global color.ui auto
- # 创建命令别名(效率翻倍)
- git config --global alias.st status
- git config --global alias.ci commit
- git config --global alias.br branch
- # 设置默认编辑器为VS Code
- git config --global core.editor "code --wait"
避坑思维导图
- 安装成功核心路径
- ├─ 安装路径 → 英文无空格
- ├─ PATH配置 → 勾选命令行集成
- ├─ 换行符 → 按操作系统选择
- └─ 身份设置 → 提前配置user.name/email
关键总结:Git安装90%的问题源于 PATH配置错误 或 换行符设置不当。严格遵循本文选项,完成后执行 git --version + git config --list 双重验证,即可彻底避开安装陷阱。