使用Yadm管理并同步配置文件

发表于 2024-09-18 更新于 2025-04-19

Dotfiles 是我们在使用软件的时候，软件为了存储我们个人偏好设置而建立的一个以 . 开头的文件。例如，vim 的配置文件就是 .vimrc，zsh 的配置文件就是 .zshrc。这些文件通常存储在用户的 home 目录中。但是，在不同的电脑上工作时，如果需要使用相同的配置，我们可以考虑使用版本控制工具来管理这些文件。或者在一台新电脑上想快速配置好环境，也可以使用版本控制工具来管理这些文件。Yadm 就可以帮助我们完成这些需求。

安装

安装 yadm 非常简单，只需在终端输入以下命令：

1	sudo pacman -S yadm

首次使用

初始化 yadm 仓库

创建一个新的 yadm 仓库很容易，只需在 home 目录中运行以下命令：

yadm init

现在，yadm 已经创建了一个空白的 git 仓库。存储库位置/home/nic/.local/share/yadm/

添加 dotfile 文件

要将现有的 dotfile 添加到 yadm 仓库中，请使用以下命令：

1	yadm add ~/.zshrc

一旦您完成了对要添加的文件的更改并将它们添加到 yadm 仓库中，您需要提交它们。可以使用以下命令：

1	yadm commit -m "Add .zshrc file to yadm repository"

建立远程仓库

使用 yadm 还可以将 dotfile 文件同步到 GitLab 等 Git 托管服务中。登录 GitLab，创建一个新的仓库。例如，您可以创建一个名为 dotfile 的仓库。现在，您需要将本地仓库与远程仓库连接起来。要将本地仓库连接到远程仓库，请使用以下命令：

1	yadm remote add origin git@gitlab.com:[用户名]/dotfile.git

现在 yadm 已经连接到您在 GitLab 上创建的仓库。要将本地代码上传到远程仓库，请使用以下命令：

1	yadm push -u orgin main

已经建立远程仓库的前提

1	yadm clone git@gitlab.com:[用户名]/dotfile.git

注意：由于远程仓库和本地仓库有可能分支名称不同，所以在建立的时候按照前述方式建立有可能会报错。为了防止错误，可以在远程先建立仓库dotfile，然后再使用yadm clone命令克隆下来，这样可以避免很多麻烦。

仓库的修改

查看当前的远程仓库地址

1	yadm remote -v

输出显示:

1 2	origin git@github.com:username/dotfiles.git (fetch) origin git@github.com:username/dotfiles.git (push)

更改远程仓库地址

1	yadm remote set-url origin <新的仓库地址>

假设你要将仓库迁移到 GitLab，新的地址为 git@gitlab.com:username/dotfiles.git，则运行：

1	yadm remote set-url origin git@gitlab.com:username/dotfiles.git

推送更改到新仓库

1	yadm push -u origin master

克隆到其他机器

1	yadm clone git@gitlab.com:username/dotfiles.git

安装