systemd-path 怎么查询当前用户的配置目录

如果脚本需要把配置写到当前用户的 systemd 目录，最稳妥的做法不是把 ~/.config 写死，而是让 systemd-path 查询实际路径。直接查询单个用户配置根目录可以使用：

# 查询当前调用环境对应的用户配置根目录
systemd-path user-configuration

# 查询用户配置目录的搜索顺序，结果是冒号分隔的目录列表
systemd-path user-configuration-search

官方地址：https://www.freedesktop.org/software/systemd/man/latest/systemd-path.html

user-configuration 返回一个目录值；带 search- 前缀的名称返回按优先级排列的搜索路径。systemd 官方还特别提醒：依赖环境变量的路径按 systemd-path 被调用时的环境计算，不能无条件等同于 systemd user manager 的环境。

因此，标题中的“当前用户配置目录”应理解为当前命令调用环境下 systemd 计算出的目录。下面把单项结果、搜索列表和环境边界拆开看。

先区分单项路径和搜索路径

systemd-path 不只会打印一个固定目录。无参数运行时，它会列出许多已知路径及当前值；传入一个名称时，只查询该名称对应的路径。名称以 search- 开头时，返回的是按优先级排列的冒号分隔列表，而不是一个可以直接拼接文件名的目录。

可以先看完整变量名，再决定脚本怎么使用：

# 列出 systemd-path 当前认识的路径名称和值
systemd-path --no-pager

# 只读取一个路径，输出适合保存到变量
config_root=$(systemd-path user-configuration)
# 统一去掉末尾换行后再拼接应用目录
printf '配置根目录：%s\n' "$config_root"
printf '应用目录：%s/my-tool\n' "$config_root"

这里的 user-configuration 是“用户配置根目录”的查询名，不是某个应用专属目录。应用名、子目录和文件名仍由应用自己的约定决定。这样写的好处是，目录来源由 systemd 和当前环境决定，文章或脚本不用假设每个发行版都采用完全相同的布局。

查询当前用户的配置目录

实际定位时，先用单项查询确认根目录，再把结果交给后续命令。不要把命令输出中的多行说明、搜索列表或日志文本直接当作目录名。

# 只保存单项路径，避免把 search- 列表当成单目录
config_root=$(systemd-path user-configuration)

# 检查结果是否为空，空值时停止继续拼接路径
if [ -z "$config_root" ]; then
  echo '未得到用户配置目录' >&2
  exit 1
fi

# 目录名由本工具自行约定，systemd-path 只负责提供根目录
tool_dir="$config_root/my-tool"
printf '%s\n' "$tool_dir"

如果只想快速确认命令是否成功，可以看退出状态：systemd-path 成功时返回 0，失败时返回非零值。目录是否已经存在是另一个问题，查询路径不会替应用创建目录。

读取配置目录的搜索顺序

当程序需要按照覆盖优先级寻找配置文件时，使用 user-configuration-search。它返回一组由冒号分隔的目录，先出现的目录具有更高搜索优先级；脚本应按路径列表逐项检查，而不是把整串文本当作一个目录。

# 读取按优先级排列的搜索目录列表
search_dirs=$(systemd-path user-configuration-search)

# IFS 只在本次循环中按冒号拆分路径列表
old_ifs=$IFS
IFS=:
for dir in $search_dirs; do
  # 只演示搜索顺序，不在这里修改配置文件
  printf '候选目录：%s\n' "$dir"
done
IFS=$old_ifs

如果配置文件要支持用户自定义位置，先理解列表的来源和顺序，再决定是否允许环境变量覆盖。尤其要注意：search- 查询的输出可能包含多个来源，单项查询的输出才适合直接作为一个目录变量。

处理环境变量和常见误区

官方手册说明，依赖环境变量的路径按命令被调用时的环境计算。因此，在交互式 shell 中看到的值，与 user manager 启动服务时使用的环境可能不同。为避免排障时误判，可以同时记录调用身份、关键环境变量和查询名。

# 记录影响路径判断的最小上下文，便于比较不同启动方式
printf 'USER=%s\n' "${USER:-未设置}"
printf 'HOME=%s\n' "${HOME:-未设置}"
printf 'XDG_CONFIG_HOME=%s\n' "${XDG_CONFIG_HOME:-未设置}"
systemd-path user-configuration

# --suffix 只改变打印出的路径后缀，不改变查询对象
systemd-path --suffix=.conf user-configuration

常见误区有三个：第一，把 user-configuration-search 当成单一目录；第二，看到一个熟悉的默认路径就认为所有发行版和启动方式都一样；第三，查询到目录后就以为目录已经创建。正确的判断顺序是先确认查询名称，再确认调用环境，最后由应用决定是否创建自己的子目录。

记住一句话即可：systemd-path 负责回答“当前调用环境下 systemd 认为路径在哪里”，应用负责决定“要不要创建子目录、怎样读取配置，以及是否需要按搜索顺序覆盖”。

相关问题

systemd-path 不带参数有什么用？

它会列出已知路径及当前值，适合先发现可查询的名称；脚本中更适合传入明确的路径名。

为什么命令输出和服务里的路径不一样？

依赖环境变量的路径按调用环境计算，交互式 shell 与 user manager 的环境可能不同。

查询到路径后会自动创建目录吗？

不会。systemd-path 只查询路径，应用需要自行决定是否创建自己的目录并处理权限。