名称: git-config 描述: 全面的Git配置指南，涵盖全局设置、别名、性能调优、凭证管理、维护、.gitattributes、克隆快捷方式和故障排除。用于基本设置之外的Git配置、优化Git性能、设置别名、管理凭证（GitHub CLI、Windows凭证管理器）、配置行结束策略、设置.gitattributes、启用Git维护或解决配置问题。为Windows、macOS和Linux提供跨平台指导。允许工具: 读取, Bash, Glob, Grep

Git配置

提供超越基本安装的Git配置全面指导。本技能涵盖全局配置、性能优化、别名、凭证管理、维护和高级配置主题。

概述

本技能帮助您：

全局配置Git以实现最佳性能和工作流
设置强大的别名以简化常见操作
安全管理Git凭证（GitHub CLI、Windows凭证管理器）
配置.gitattributes以控制行结束
启用Git维护以提高仓库性能
理解仓库级与全局配置
解决常见配置问题

对于基本Git安装和设置，请参阅setup技能。

示例用例

本技能适用于以下问题：

“如何为常见操作设置Git别名？”
“配置Git使用GitHub CLI进行身份验证”
“我的Git在大仓库上很慢——如何优化性能？”
“为跨平台开发设置.gitattributes”
“启用Git后台维护”
“解决‘拒绝允许OAuth应用创建工作流’错误”
“在Windows上配置Git凭证助手”
“为常用仓库设置克隆快捷方式”
“配置rerere以记住合并冲突解决方案”

何时使用本技能

在以下情况使用本技能：

超越基本用户身份的Git配置
设置常见Git操作的别名
优化Git性能（fsmonitor、untrackedCache、并行操作）
管理Git凭证（HTTPS、SSH、令牌范围）
设置GitHub CLI作为凭证助手
配置.gitattributes以控制跨平台行结束
启用Git后台维护
为常用仓库设置克隆快捷方式
解决凭证问题或行结束错误
理解Git配置层次结构（系统/全局/本地）

快速开始

立即应用的最有影响力的配置设置：

# 性能改进
git config --global core.fsmonitor true
git config --global core.untrackedCache true
git config --global fetch.parallel 8
git config --global checkout.workers 8

# 更好的拉取/变基工作流
git config --global pull.rebase true
git config --global rebase.autoStash true
git config --global rebase.updateRefs true

# 自动修剪删除的远程分支
git config --global fetch.prune true
git config --global fetch.pruneTags true

# 更好的合并冲突解决方案
git config --global merge.conflictstyle zdiff3

# 首次推送时自动设置远程跟踪
git config --global push.autoSetupRemote true

# 更好的差异算法
git config --global diff.algorithm histogram
git config --global diff.colorMoved zebra

# 行结束安全检查
git config --global core.safecrlf warn

快速参考

按类别组织的常见Git配置设置（性能、拉取/变基、获取、推送、差异、合并、行结束、排序、维护）。

📚 完整快速参考表： references/quick-reference.md

快速参考表提供所有常见设置的复制粘贴命令，按类别组织和目的解释。

配置文件位置

有关Git配置文件位置、层次结构和查看配置的详细信息，请参阅references/configuration-basics.md。

快速摘要：

系统：/etc/gitconfig（在Windows上为Git安装目录） - 所有用户
全局：~/.gitconfig或~/.config/git/config - 当前用户
本地：.git/config - 仅单个仓库
优先级：本地 > 全局 > 系统

查看配置：

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

# 查看特定值
git config user.name

全局配置设置

这些设置是跨平台的，推荐所有用户使用。除非需要仓库特定覆盖，否则应在全局级别设置。

最基本设置（快速开始）：

# 拉取和变基（更清洁的历史）
git config --global pull.rebase true
git config --global rebase.autoStash true

# 获取（自动修剪删除的分支/标签）
git config --global fetch.prune true
git config --global fetch.pruneTags true
git config --global fetch.parallel 8

# 推送（自动设置远程跟踪）
git config --global push.autoSetupRemote true

# 差异和合并（更好的算法和冲突显示）
git config --global diff.algorithm histogram
git config --global diff.colorMoved zebra
git config --global merge.conflictstyle zdiff3

# 性能（文件系统监控）
git config --global core.fsmonitor true
git config --global core.untrackedCache true

# 排序（最新优先）
git config --global branch.sort -committerdate
git config --global tag.sort -taggerdate

📚 完整全局配置指南： references/global-configuration.md

涵盖主题：拉取和变基策略、获取策略、推送策略、检出/切换策略、提交设置、状态设置、差异设置、合并设置、rerere（冲突解决方案记忆）、颜色设置、排序、日志设置、性能设置、子模块策略、杂项设置和高级配置选项。

管理rerere（重用记录的解决方案）

Git的rerere功能记住您如何解决合并冲突，并可以自动重新应用这些解决方案。

启用rerere：

git config --global rerere.enabled true
git config --global rerere.autoUpdate true

有关rerere工作原理、安全考虑和管理命令的详细信息，请参阅references/configuration-basics.md

行结束策略（深度防御）

跨平台行结束管理采用分层方法：

系统级别（autocrlf）：平台特定默认值（Windows：true，macOS/Linux：input）
全局级别（safecrlf）：警告混合行结束（实际问题）但允许合法转换
仓库级别（.gitattributes）：按文件类型显式控制

深度防御： 这些设置是互补的，不冲突：

autocrlf自动处理转换
safecrlf=warn警告问题（混合行结束）但不阻止.gitattributes转换
.gitattributes提供每仓库细粒度控制

重要： 当您有.gitattributes时，不要使用safecrlf=true——它会阻止合法转换并导致持续错误！

平台特定autocrlf设置：

Windows：git config --global core.autocrlf true（检出时将LF→CRLF转换，提交时将CRLF→LF转换）
macOS/Linux：git config --global core.autocrlf input（提交时将CRLF→LF转换，检出时无转换）
WSL：git config --global core.autocrlf input（与Linux相同）

全局safecrlf设置（所有平台）：

# 警告混合行结束（防止问题）
# 使用'warn'而非'true'——允许.gitattributes工作而无持续错误
git config --global core.safecrlf warn

有关.gitattributes设置和全面行结束指导的详细信息，请参阅line-endings技能。

别名

别名为常见Git操作提供快捷方式。类别包括：信息和检查、导航、分支操作、暂存/取消暂存、提交、历史编辑、远程操作和标签推送工作流。

最常见别名：

# 状态和分支信息
git config --global alias.st "status -sb"
git config --global alias.br "branch -vv"

# 现代分支切换
git config --global alias.co "switch"
git config --global alias.cob "switch -c"

# 快速修正
git config --global alias.amend "commit --amend --no-edit"

# 安全强制推送
git config --global alias.pfwl "push --force-with-lease"

📚 完整别名指南： references/aliases.md

涵盖主题：信息和检查别名、导航实用程序、分支操作、暂存/取消暂存快捷方式、提交助手、历史编辑（危险！）、远程操作、标签推送工作流、使用url.insteadOf的克隆快捷方式、组织/个人简写模式和自定义模板。

克隆快捷方式

Git的url.insteadOf功能为克隆URL创建简写前缀。例如：git clone gh:username/repo而不是git clone git@github.com:username/repo.git。

快速示例：

# 通用GitHub简写
git config --global url."git@github.com:".insteadOf "gh:"
# 用法：git clone gh:microsoft/vscode

📚 完整克隆快捷方式指南： references/aliases.md#克隆快捷方式

涵盖主题：通用GitHub简写、组织/个人快捷方式、公司Git服务器、自定义命名空间模板和使用示例。

仓库级配置

这些设置是上下文特定的——在需要时在单个仓库中使用，不作为全局默认值。

何时使用仓库级配置：

仓库特定要求（子模块、性能、大小）
为特定工作流覆盖全局设置
该仓库的团队特定约定

示例：

# 在特定仓库中启用子模块递归
git config submodule.recurse true

# 在大型仓库中禁用前后比较（性能）
git config status.aheadBehind false

# 覆盖行结束策略（使用.gitattributes）
git config core.autocrlf false

维护

Git可以执行后台维护以保持仓库快速（提交图更新、增量重新打包、松散对象清理）。

快速设置：

# 为您的账户启用后台维护一次
git maintenance start

# 注册每个活动仓库进行维护
git maintenance register

# 全局启用提交图生成
git config --global gc.writeCommitGraph true

常见命令：

# 立即运行维护
git maintenance run

# 查看哪些仓库已注册
git config --global --get-all maintenance.repo

# 取消注册仓库
git maintenance unregister

📚 完整维护指南： references/global-configuration.md#维护

涵盖主题：后台维护任务、调度（每小时/每日/每周）、任务配置、禁用完整gc、maintenance.auto设置、每任务启用、故障排除维护问题。

Git属性

.gitattributes提供按文件类型显式控制行结束。这是跨平台团队的推荐方法。

最佳实践： 在.gitattributes中控制行结束，并使用平台适当的autocrlf设置与safecrlf=warn。

快速示例：

# 自动检测文本文件并规范化行结束
* text=auto

# 强制脚本/配置使用LF（Shell和CI工具期望LF）
*.sh      text eol=lf
*.yml     text eol=lf
*.json    text eol=lf

# 强制Windows特定文件使用CRLF
*.ps1     text eol=crlf
*.cmd     text eol=crlf
*.bat     text eol=crlf

# 标记二进制文件
*.png binary
*.jpg binary
*.pdf binary

规范化具有混合行结束的现有仓库：

git add --renormalize .
git commit -m "Normalize line endings"

📚 有关全面.gitattributes设置、Git LFS模式和行结束策略的详细信息，请参阅line-endings技能。

Git凭证管理

Git使用凭证助手来存储和检索远程操作（克隆、获取、推送）的身份验证凭证。理解凭证管理对于安全、高效的Git工作流至关重要。

有关全面凭证管理指导，请参阅references/credential-management.md。

快速概述：

Windows：默认凭证助手是Windows凭证管理器（manager）
macOS：默认是macOS钥匙串（osxkeychain）
Linux：默认是内存缓存（cache）或用于持久存储的libsecret
GitHub用户：推荐混合设置（GitHub使用gh CLI，其他使用OS凭证管理器）

GitHub快速设置（混合方法）：

# 1. 使用gh CLI进行身份验证
gh auth login --scopes "repo,read:org,workflow" --git-protocol https

# 2. 仅针对GitHub配置gh CLI作为凭证助手
gh auth setup-git

# 3. 验证混合设置
git config --list | grep credential
# 应显示：
# - credential.helper=manager（或osxkeychain/cache - OS默认）
# - credential.https://github.com.helper=!gh auth git-credential（GitHub特定）

常见凭证问题：

“拒绝允许OAuth应用创建或更新工作流” → 需要workflow范围
Git仍使用旧/错误凭证 → 清除OS凭证缓存
SSH与HTTPS混淆 → 使用git remote -v检查远程URL

有关详细故障排除、凭证助手选项、安全最佳实践和平台特定指导，请参阅references/credential-management.md。

故障排除

有关全面故障排除指导，请参阅references/troubleshooting.md。

快速链接：

行结束错误 - “LF将替换为CRLF”警告
凭证问题 - OAuth错误、过时凭证、SSH与HTTPS
性能问题 - git状态慢、获取超时
常见实际场景 - 公司代理、WSL问题、rerere问题

测试场景

有关验证技能激活和响应质量的测试场景，请参阅references/test-scenarios.md。

覆盖范围： 9个场景，涵盖基本使用（别名、性能、维护）、高级使用（凭证、行结束、仓库配置）、故障排除（凭证问题、rerere）和快捷方式（克隆快捷方式、url.insteadOf）。

版本历史

v1.3.0 (2025-11-25)：审计合规性改进
- 提取测试场景到references/test-scenarios.md
- 将SKILL.md从539行减少到约475行（低于500行推荐）
- 改进渐进披露合规性
v1.2.0 (2025-11-12)：基于审计建议的质量改进
- 提取配置文件位置到references/configuration-basics.md
- 提取管理rerere到references/configuration-basics.md
- 提取故障排除到references/troubleshooting.md
- 添加多模型测试笔记
- 添加常见实际使用场景
- 将SKILL.md行数从959减少到约700行（提高性能）
- 为所有参考文件添加目录以改进导航
- 创建references/troubleshooting.md，提供全面故障排除指导
v1.1.0 (2025-11-12)：基于审计反馈的可用性增强
- 添加示例用例部分，提供具体激活示例
- 添加快速参考表，便于快速查找常见设置
- 改进自主激活可靠性
v1.0.0 (2025-11-09)：初始发布，提供全面Git配置指导

官方文档

最后更新

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

Git全面配置与管理指南Skill git-config