Git安装和配置全攻略：从入门到进阶

一、Git安装：多平台适配与版本选择

1.1 Windows平台安装

Windows用户可通过官方安装包或命令行工具安装Git。推荐使用Git for Windows（官网下载），该版本包含Git Bash（类Linux终端）、Git GUI（图形化工具）及Windows命令行集成。

• 安装步骤：

  1. 访问Git官网，下载64位安装包。
  2. 运行安装程序，勾选“Use Git and optional Unix tools from the Command Prompt”（将Git工具添加至PATH环境变量）。
  3. 选择默认编辑器（推荐VS Code或Notepad++）。
  4. 配置行尾转换：Windows用户建议选择“Checkout as-is, commit Unix-style line endings”（避免跨平台文件格式问题）。
  5. 完成安装后，在命令行输入git --version验证安装成功。

• 进阶建议：

  • 使用choco install git（需先安装Chocolatey包管理器）快速安装。
  • 通过scoop install git（Scoop用户）实现无界面安装。

1.2 macOS平台安装

macOS可通过Homebrew或官方安装包安装Git，推荐使用Homebrew以保持版本最新。

• 安装步骤：

  1. 安装Homebrew（若未安装）：

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  2. 通过Homebrew安装Git：

     brew install git

  3. 验证安装：

     git --version

• 替代方案：

  • 直接从Git官网下载安装包。
  • 使用Xcode命令行工具（需先安装Xcode）：

    xcode-select --install

1.3 Linux平台安装

Linux用户可通过包管理器快速安装Git，不同发行版命令略有差异。

• Ubuntu/Debian：

  sudo apt update
  sudo apt install git

• CentOS/RHEL：

  sudo yum install git

• Arch Linux：

  sudo pacman -S git

• 验证安装：

  git --version

二、Git基础配置：用户信息与全局设置

2.1 配置用户信息

Git要求每个提交（commit）必须包含用户名称和邮箱，用于标识代码贡献者。

• 全局配置（影响所有仓库）：

  git config --global user.name "Your Name"
  git config --global user.email "[e-mail]"

• 项目级配置（仅影响当前仓库）：

  cd /path/to/your/repo
  git config user.name "Project-Specific Name"
  git config user.email "[e-mail]"

2.2 配置默认编辑器

Git默认使用系统默认编辑器（如Windows的记事本），可修改为更友好的工具（如VS Code、Vim）。

• 设置VS Code为默认编辑器：

  git config --global core.editor "code --wait"

  • --wait参数确保Git等待编辑器关闭后再继续执行。

2.3 配置缓存与凭据

Git支持缓存用户凭据，避免每次操作都需输入账号密码。

• 启用凭据缓存（缓存15分钟）：

  git config --global credential.helper cache

• 长期存储凭据（需安装Git Credential Manager）：

  # Windows（默认已安装）
  git config --global credential.helper manager
  # macOS/Linux（需安装）
  git config --global credential.helper osxkeychain  # macOS
  git config --global credential.helper /usr/share/doc/git/contrib/credential/libsecret/git-credential-libsecret  # Linux（需安装libsecret）

三、Git进阶配置：提升效率与安全性

3.1 配置别名（Alias）

通过别名简化常用命令，提升操作效率。

• 示例配置：

  git config --global alias.co checkout
  git config --global alias.br branch
  git config --global alias.ci commit
  git config --global alias.st status
  git config --global alias.lg "log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit"

  • 使用后，git lg可显示带颜色和图形的日志。

3.2 配置忽略规则（.gitignore）

通过.gitignore文件排除不需要跟踪的文件（如日志、编译产物）。

• 全局忽略规则（适用于所有仓库）：

  git config --global core.excludesfile ~/.gitignore_global

  • 创建~/.gitignore_global文件，添加规则如：

    # 忽略所有.log文件
    *.log
    # 忽略node_modules目录
    node_modules/
    # 忽略IDE配置文件
    .idea/
    .vscode/

3.3 配置SSH密钥（安全访问）

使用SSH密钥替代HTTPS认证，提升安全性和便捷性。

• 生成SSH密钥：

  ssh-keygen -t ed25519 -C "[e-mail]"

  • 默认保存在~/.ssh/id_ed25519.pub（公钥）和~/.ssh/id_ed25519（私钥）。

• 添加公钥至Git平台：

  • 复制公钥内容：

    cat ~/.ssh/id_ed25519.pub

  • 粘贴至GitHub/GitLab等平台的SSH密钥设置中。

• 测试连接：

  ssh -T [e-mail]

  • 成功响应：Hi username! You've successfully authenticated...

四、常见问题与解决方案

4.1 安装后无法识别git命令

• 原因：未将Git添加至系统PATH环境变量。
• 解决方案：
  • Windows：重新运行安装程序，勾选“Add Git to PATH”。
  • macOS/Linux：确保安装包已正确配置PATH（通常无需手动操作）。

4.2 提交时提示“Please tell me who you are”

• 原因：未配置用户名称或邮箱。
• 解决方案：

  git config --global user.name "Your Name"
  git config --global user.email "[e-mail]"

4.3 SSH认证失败

• 原因：私钥权限过松或公钥未正确添加。
• 解决方案：
  • 修改私钥权限：

    chmod 600 ~/.ssh/id_ed25519

  • 重新添加公钥至Git平台。

五、总结与建议

Git的安装和配置是版本控制的基础，合理设置可显著提升开发效率。关键步骤总结：

1. 根据操作系统选择合适的安装方式。
2. 配置全局用户信息和默认编辑器。
3. 启用凭据缓存或SSH密钥认证。
4. 通过别名和忽略规则优化日常使用。

进阶建议：

• 定期更新Git至最新版本（通过包管理器或官网）。
• 使用git config --list检查当前配置。
• 针对团队项目，统一.gitignore和代码风格规则。

通过以上步骤，开发者可快速完成Git的安装与配置，为后续的代码管理、协作开发奠定坚实基础。