如何备份和迁移Git配置文件存储路径中的数据

胖静姑娘_7549

胖静姑娘_7549

2026-10-19

213人浏览

原创

git配置文件(如.gitconfig)仅存行为设置,不存数据;真正需备份的是凭证(如~/.git-credentials或系统凭据库)、ssh密钥(~/.ssh/)、gpg密钥(~/.gnupg/)、全局忽略文件及环境变量等外部依赖项。

如何备份和迁移git配置文件存储路径中的数据

Git配置文件本身不存数据,真正要备份的是 .gitconfig 和凭证、SSH密钥等关联项

Git 的配置文件(如 ~/.gitconfig 或 %USERPROFILE%\.gitconfig)只是纯文本,不包含仓库数据或历史记录。它只控制行为:默认分支名、编辑器、换行符策略、别名等。真正影响“数据迁移成败”的是那些 Git 依赖但不直接写在 .gitconfig 中的外部组件:

  • git-credential 存储的密码或 token(比如 git config --global credential.helper store 写入的 ~/.git-credentials)
  • SSH 私钥(~/.ssh/id_rsa 等)——如果用 SSH 协议克隆/推送
  • GPG 密钥(~/.gnupg/)——如果启用 commit 签名
  • 全局 core.excludesfile 指向的忽略规则文件(如 ~/.gitignore_global)

迁移前必须检查 git config --list --show-origin 查清所有配置来源

Git 配置分三层:系统级(/etc/gitconfig)、用户级(~/.gitconfig)、仓库级(.git/config)。不同层级可能覆盖同一选项,仅复制 ~/.gitconfig 会漏掉系统级别设置(比如公司统一配的 core.autocrlf),也可能被新环境的系统配置意外覆盖。

  • 运行 git config --list --show-origin,输出每行开头会标出该配置来自哪个文件
  • 重点关注重复出现的 key(如多个 user.name),确认最终生效的是哪一层
  • 若目标机器有预装 Git(如 macOS 自带或 Git for Windows),其 /etc/gitconfig 可能含默认值,迁移时需手动比对

凭证和密钥不能靠 .gitconfig 备份,必须单独导出和校验

.gitconfig 里只有 credential.helper 的类型声明(如 manager、osxkeychain、store),实际凭据存在操作系统凭据库或明文文件中。迁移后若没同步这些,git push 会卡在认证环节。

github-trending
github-trending

获取今日/本周/本月GitHub 热门仓库,并汇总前 15 名的星数、语言和描述。

下载
  • Windows:用 cmdkey /list 查看 Git 凭据是否存于 Windows Credential Manager;导出需用 PowerShell 脚本调用 CredentialManager 模块(原生命令不支持批量导出)
  • macOS:凭据在钥匙串(Keychain),名称通常含 git:https://github.com;可用 security find-internet-password -s github.com -w 提取单条,但批量需脚本遍历
  • Linux(store 方式):直接备份 ~/.git-credentials,但注意该文件权限应为 600,否则 Git 会拒绝读取
  • SSH 密钥:用 ssh-keygen -l -f ~/.ssh/id_rsa 校验私钥有效性;公钥(id_rsa.pub)需重新添加到 GitHub/GitLab

路径相关配置(如 core.editor、init.templateDir)迁移后大概率失效

很多配置值是绝对路径,比如 core.editor 指向 /usr/local/bin/code --wait,或 init.templateDir 指向 /Users/alice/git-templates。旧路径在新机器上不存在,Git 会静默忽略或报错。

  • 迁移后立即运行 git config --global --edit,人工检查所有含路径的字段
  • 常见易错项:core.editor、diff.tool、merge.tool、init.templateDir、include.path
  • 推荐用相对路径或跨平台工具名(如 code --wait 而非完整路径),并确保对应 CLI 工具已安装且在 $PATH 中

最麻烦的不是配置文件本身,而是那些没出现在 git config 输出里、却实际影响行为的环境变量(如 GIT_SSH_COMMAND)和 shell 别名。它们不会被任何 Git 命令导出,得靠 env | grep GIT 和 alias | grep git 单独捕获。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

2023.07.05

6279

9

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

2023.07.06

1820

6

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

2023.07.24

1074

5

git提交错误怎么撤回
git提交错误怎么撤回

git提交错误撤回的方法:git reset head^:撤回最后一次提交,恢复到提交前状态。git revert head:创建新提交,内容与之前提交相反。git reset :使用提交的 sha-1 哈希撤回指定提交。交互式舞台区:标记要撤回的特定更改,然后提交,排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.09

4097

7

git怎么对比两个版本的文件内容
git怎么对比两个版本的文件内容

要对比两个版本的 git 文件,请使用 git diff 命令:git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块,其中 + 表示添加的行,- 表示删除的行, 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.09

3841

6

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

2026.10.16

20

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

0

10

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

2026.10.16

0

10

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
vscode手册
vscode手册

共0课时 | 0人学习

Git 教程
Git 教程

共21课时 | 8万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.9万人学习