git config:键名格式无效
快速摘要
你传给 git config 的键格式错误 —— 键必须遵循 section.subsection.variable 格式且使用有效字符。
为什么发生
键包含无效字符 —— 节名和变量名只允许字母数字、连字符和点
节名为空或键的点太少,如 'user' 而非 'user.name'
子节名包含点但未加引号,使键解析器混淆节和变量的边界
最小示例
✗ 错误代码
git config user name 'John' # error: invalid key: 'user name'✓ 修复代码
git config user.name 'John' # correct dot-separated key format键必须用点分隔节和变量 —— 空格使 git 将其解释为无效键名。
如何诊断
检查键格式 —— 应为 section.variable 或 section.subsection.variable,不含空格
运行 git config --list 查看现有有效键,与你的目标键比较格式
使用 git config --get <key> 在设置前测试键是否被识别
如何修复
将键修正为有效格式:section.variable 或 section.subsection.variable,用点正确分隔
如果子节包含特殊字符,用引号包裹整个键:git config 'user."full name".email' value
使用 --add 标志配合完全限定的键,避免节与变量解析的歧义
如何预防
遵循 git config 文档中的有效键命名约定,始终使用 section.variable 格式
对于复杂的多点键,使用 git config --file 直接用文本编辑器编辑配置文件
相关资源
相关术语
相关课程
- git config
学习 git 配置。