Layui 是一款轻量级的前端 UI 框架
参考资料
以下是一份超详细的 Git安装避坑指南,涵盖全平台(Windows/macOS/Linux)的核心配置、常见问题及底层原理,助你彻底避开安装陷阱:
一、安装前的关键决策
1. 官方渠道下载(严防捆绑软件)
Windows:
唯一可信源:git-scm.com
陷阱:第三方下载站可能植入广告或恶意软件
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)
选项 | 是否勾选 | 说明 |
---|---|---|
Git Bash Here | ✔️ | 资源管理器右键菜单必备 |
Git GUI Here | ✔️ | 图形化操作备用 |
Associate .git files* | ✔️ | 关联Git配置文件 |
Associate .sh files | ⚠️ | 仅开发者需要 |
Daily Check | ❌ | 禁用自动更新检查 |
步骤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-style
core.autocrlf=true
Linux/macOS Checkout as-is, commit Unix-style
core.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 # 复制公钥
问题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
双重验证,即可彻底避开安装陷阱。