Skip to content

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 直接用文本编辑器编辑配置文件

相关资源

相关术语

相关课程

← 返回语言