⚡

Git安装与配置指南Skill setup

这个技能提供全面的Git安装和初始配置指南，覆盖Windows、macOS、Linux和WSL平台。帮助用户快速安装Git、配置用户身份、设置默认分支、选择编辑器并进行验证。关键词：Git安装、Git配置、版本控制、开发工具、跨平台、DevOps。

DevOps 0 次安装 0 次浏览 更新于 3/11/2026

名称: 安装 描述: 在所有平台（Windows、macOS、Linux、WSL）上安装Git并进行基本配置的完整指南。适用于首次设置Git、在新系统上安装Git、配置用户身份、设置默认分支、选择编辑器、验证安装或解决Git安装问题。涵盖平台特定的安装方法、基本必需配置和验证步骤。 允许工具: Read, Bash, Glob, Grep

Git 安装

为Windows、macOS、Linux和WSL环境提供安装Git和执行必要初始配置的完整指导。

目录

概述

这个技能帮助您：

  • 使用最适合您平台的方法安装Git
  • 配置必要的Git设置（用户身份、默认分支、编辑器）
  • 验证您的安装是否正常工作
  • 理解平台特定的考虑因素
  • 使用推荐的默认值快速开始

对于高级配置（别名、性能调优、凭据管理、维护），请参见 git-config 技能。

何时使用此技能

使用此技能当：

  • 在新的开发机器上安装Git
  • 在任何平台上首次设置Git
  • 配置用户身份和基本Git设置
  • 验证Git安装是否正常工作
  • 解决Git安装问题
  • 理解平台特定的Git安装选项
  • 在Windows、macOS、Linux或WSL上设置Git

快速开始

获取Git安装和配置的最快路径：

Windows

# 安装 Git
winget install --id Git.Git -e --source winget

# 配置身份
git config --global user.name "您的姓名"
git config --global user.email "your.email@example.com"
git config --global init.defaultBranch main

# 验证
git --version

macOS

# 安装 Git
brew install git

# 配置身份
git config --global user.name "您的姓名"
git config --global user.email "your.email@example.com"
git config --global init.defaultBranch main

# 验证
git --version

Linux

# 安装 Git（Ubuntu/Debian）
sudo apt update && sudo apt install git

# 配置身份
git config --global user.name "您的姓名"
git config --global user.email "your.email@example.com"
git config --global init.defaultBranch main

# 验证
git --version

平台检测

当帮助用户安装Git时，使用环境指示器检测他们的平台：

  • Windows: $env:OS 包含 “Windows”，PowerShell命令，winget，文件路径如 C:\
  • macOS: uname -s 返回 “Darwin”，Homebrew (brew)，~/.zshrc
  • Linux: uname -s 返回 “Linux”，包管理器（apt、dnf、pacman），~/.bashrc
  • WSL: Linux内核 + Windows集成（例如，/mnt/c/），wsl.exe 可用

基于检测到或声明的平台自动提供平台特定的指导。

Windows 安装

两种安装选项：Git for Windows 安装程序（完全控制，推荐）或 winget（快速安装）。包括Windows特定的配置（长路径、系统级设置）和故障排除。

📚 完整指南： references/install-windows.md

涵盖主题：安装选项、验证、Windows特定配置、Win32长路径、故障排除、Git Bash历史问题

macOS 安装

两种安装选项：Xcode Command Line Tools（快速，内置）或 Homebrew（最新版本，推荐）。包括macOS特定的配置、shell集成（Zsh/Bash）和全局gitignore设置。

📚 完整指南： references/install-macos.md

涵盖主题：安装选项、验证、行尾配置、Zsh/Bash shell集成、全局gitignore

Linux 安装

通过包管理器安装：apt（Ubuntu/Debian）、dnf（Fedora/RHEL）或 pacman（Arch Linux）。包括Linux特定的配置、shell集成（Bash/Zsh）和全局gitignore设置。

📚 完整指南： references/install-linux.md

涵盖主题：发行版特定安装、验证、行尾配置、Bash/Zsh shell集成、全局gitignore

WSL（Windows Subsystem for Linux）

WSL运行Linux（默认为Ubuntu），因此Git安装与原生Linux相同。包括WSL特定的配置和性能考虑。

📚 完整指南： references/install-wsl.md

涵盖主题：安装（与Linux相同）、验证、WSL特定配置、文件系统性能说明、Windows集成、凭据共享

基本配置（所有平台）

安装Git后，配置这些必要设置：

设置用户身份（必需）

git config --global user.name "您的姓名"
git config --global user.email "your.email@example.com"

重要：此信息包含在每个提交中。使用您的真实姓名和工作/个人电子邮件。

设置默认分支名称

git config --global init.defaultBranch main

注意：现代标准是 main（替换旧的 master 约定）。

设置首选编辑器（可选）

选择一种：

# VS Code（必须在 PATH 中）
git config --global core.editor "code --wait"

# Notepad（Windows）
git config --global core.editor "notepad"

# Vim
git config --global core.editor "vim"

# Nano（Linux/macOS）
git config --global core.editor "nano"

注意：如果未设置，Git使用系统默认编辑器（通常在Linux/macOS上是Vim，在Windows上是Notepad）。

验证

安装和配置后，验证一切是否正常工作：

检查 Git 版本

git --version

验证配置

# 查看所有配置及源文件
git config --list --show-origin

# 查看特定值
git config user.name
git config user.email
git config init.defaultBranch

测试基本 Git 操作

# 创建测试仓库
mkdir test-repo
cd test-repo
git init

# 创建并提交文件
echo "# Test Repository" > README.md
git add README.md
git commit -m "Initial commit"

# 查看提交历史
git log

# 清理
cd ..
rm -rf test-repo

预期结果：仓库创建成功，提交成功，日志显示您的提交。

配置文件位置

有关配置文件位置、层次结构、条件包含和故障排除的完整详细信息，请参见配置详情。

快速参考：

  • 系统：/etc/gitconfig（所有用户，需要 sudo）
  • 全局：~/.config/git/config 或 ~/.gitconfig（当前用户）
  • 本地：.git/config（当前仓库）
  • 层次结构：本地 > 全局 > 系统

取消设置配置值

要删除/取消设置配置值：

# 取消系统配置值（需要管理员/sudo）
git config --system --unset status.aheadbehind

# 取消全局/用户配置值
git config --global --unset status.aheadbehind

# 取消本地配置值（在仓库内）
git config --unset status.aheadbehind

参考加载指南

此技能中的所有参考都是基于平台检测或故障排除上下文条件加载的。这种渐进式披露策略通过仅在需要时加载相关内容来保持技能效率。

始终加载（核心）

  • 无 - 所有参考都是上下文相关的，按需加载

条件加载

  • references/install-windows.md - 当用户在Windows平台时加载（安装工作流）
  • references/install-macos.md - 当用户在macOS平台时加载（安装工作流）
  • references/install-linux.md - 当用户在Linux平台时加载（安装工作流）
  • references/install-wsl.md - 当用户在WSL平台时加载（安装工作流）
  • references/git-bash-history-troubleshooting.md - 当解决Windows Terminal上的Git Bash命令历史问题时加载

令牌效率：大多数用户遵循快速开始路径（约3k令牌）。平台特定的深入指南仅加载相关参考（总计约3.5-4k令牌）。

后续步骤

完成基本Git设置后，考虑：

  1. 高级配置：使用 git-config 技能进行：

    • 全面的全局配置（性能、别名、维护）
    • 凭据管理（GitHub CLI、Windows Credential Manager）
    • 克隆快捷方式（为常见仓库节省输入）

  2. 行尾管理：使用 line-endings 技能进行：

    • 理解行尾配置
    • 为跨平台团队设置 .gitattributes
    • 解决行尾问题
    • Git LFS 设置用于大文件

  3. 提交签名：使用 gpg-signing 技能进行：

    • 设置GPG提交签名
    • 生成和管理GPG密钥
    • 将GPG密钥添加到GitHub/GitLab
    • 解决签名问题

  4. GUI工具：使用 gui-tools 技能进行：

    • 安装Git GUI客户端（GitKraken、Sourcetree、GitHub Desktop）
    • 配置GUI工具
    • 选择适合您工作流的GUI

相关技能

  • config：全面的Git配置（别名、性能、凭据、维护）
  • line-endings：行尾配置、.gitattributes、Git LFS
  • gpg-signing：GPG提交签名设置和故障排除
  • gui-tools：Git GUI客户端安装和配置

测试与评估

有关全面的测试场景、多模型测试笔记、正式评估和开发方法，请参见测试与评估。

评估总结：3/3 评估通过 - 使用 Claude Sonnet 4.5 和 Claude Sonnet 3.5 测试

参考

安装指南：

  • Windows 安装 - winget、Git for Windows 安装程序、Win32 长路径
  • macOS 安装 - Xcode Command Line Tools、Homebrew、Zsh 集成
  • Linux 安装 - apt、dnf、pacman、Bash/Zsh 集成
  • WSL 安装 - 与 Linux 相同、WSL2 性能、凭据共享

配置：

  • 配置详情 - 文件位置、层次结构、条件包含、故障排除

故障排除：

测试：

版本历史

  • v1.3.0 (2025-11-28)：令牌优化 - 将配置详情和测试提取到 references/，将 SKILL.md 从 526 行减少到约 400 行
  • v1.2.0 (2025-11-25)：全面审计改进 - 增强 WSL 参考，更新 Git 版本到 2.47.0+
  • v1.1.0 (2025-01-11)：添加 Windows Terminal Git Bash 命令历史故障排除参考
  • v1.0.0 (2025-01-06)：初始发布，包含全面的 Git 安装和配置指导

官方文档

最后更新

日期： 2025-11-28 模型： claude-opus-4-5-20251101