Linux readlink 命令:查看符号链接目标与失效链接
readlink默认输出符号链接中保存的目标路径字符串,适合检查相对链接或查看失效链接原来指向哪里。GNU 还提供 -f、-e、-m 路径规范化模式;需要规范路径或相对输出时,通常优先考虑 realpath。
readlink 读取的是什么?
参数是可读取的符号链接时,默认模式返回该链接保存的目标,而不读取目标文件内容:
readlink current
若链接 current 保存的是 releases/2026-09,则输出:
releases/2026-09
这个字符串不保证是绝对路径,也不证明目标存在。相对目标从链接所在目录解释;默认 readlink 不把最后这个链接的目标继续解析成最终绝对位置。
基本语法与准备事项
readlink [options] file...
options 和 file... 是语法占位符。GNU 支持多个参数;POSIX.1-2024(可移植操作系统接口规范)的基本形式是 readlink [-n] file,多参数与 GNU 规范化选项需要核对目标实现。
在可写、专门用于练习的目录中,确认 current 尚不存在,再执行以下示例。它创建链接,不创建发布目录,也不覆盖已有名称;只有创建成功才读取:
ln -s releases/2026-09 current && readlink current
目标即使尚不存在也可以创建符号链接。如果系统不支持创建链接或权限不足,ln 会失败;先检查错误,不要把复制文件的替代行为当作 Linux 符号链接测试结果。重复练习前核对已有对象,不能随意删除或覆盖真实部署链接。
默认模式对普通文件或目录没有可读的链接目标,会返回非零状态。以下例子假设 /etc/passwd 是普通文件:
readlink /etc/passwd
printf '%s\n' "$?"
第一行通常没有标准输出,第二行显示第一条命令的退出状态,通常是 1。$? 必须紧接要检查的命令保存或打印,否则会被后续命令状态覆盖;这段代码最终状态来自 printf,不能把它当作自动向调用者传播 readlink 失败的脚本。
相对链接与绝对链接
相对目标以链接所在目录为基准
下面继续在练习目录中操作。先确认 readlink-demo 是你的专用演示目录,且其中的 app/config.yml 尚不存在:
mkdir -p readlink-demo/app readlink-demo/shared &&
ln -s ../shared/config.yml readlink-demo/app/config.yml &&
readlink readlink-demo/app/config.yml
输出 ../shared/config.yml。它从 readlink-demo/app 出发,指向同一演示树中的 readlink-demo/shared/config.yml;这里没有创建目标配置文件,因此目标仍可不存在。即使从另一个工作目录调用 readlink,保存的相对目标也不会自动改成以终端当前位置为基准。
绝对目标从根路径开始
在前例的演示目录已存在、absolute-link 尚不存在时,可创建保存绝对目标字符串的链接:
ln -s /srv/releases/2026-09 readlink-demo/absolute-link &&
readlink readlink-demo/absolute-link
输出为:
/srv/releases/2026-09
这只在本地演示目录建立链接,不创建或修改 /srv 中的对象。绝对目标定位明确,但把整个目录树搬到另一位置后,链接仍指向原绝对路径;相对目标则适合保持目录树内部相对布局。应按部署和迁移要求选择。
检查失效链接
只要链接本身能读取,即使目标不存在,默认 readlink 仍能显示它保存的字符串。在练习目录确认同名对象尚不存在,且 missing-target 不存在后执行:
ln -s missing-target broken-link && readlink broken-link
missing-target
可进一步结合 shell 的文件测试:
if [ -L broken-link ] && [ ! -e broken-link ]; then
printf '%s\n' '链接目标不存在或当前无法访问。'
fi
-L 检查该路径本身是否为符号链接,-e 则尝试跟随链接判断目标是否存在。不过权限不足、链接循环或解析障碍也可能让 -e 为假,所以这个组合提示“目标不存在或无法确认”,不能在任何环境下都断定目标已删除。测试与之后使用之间仍可能发生变化。
GNU 路径规范化选项
规范化模式可以接受普通文件路径,不再要求最后输入对象本身就是符号链接;会按选项解析沿途链接和点组件:
| 选项 | 存在条件与行为 |
|---|---|
-f、--canonicalize |
解析后的最后名称可缺失;此前组件必须存在并可用。当前 GNU 文档说明忽略末尾斜杠;旧版本或其他平台应核对实际行为。 |
-e、--canonicalize-existing |
所有组件必须存在并可解析;末尾斜杠要求目标为目录。 |
-m、--canonicalize-missing |
缺失或不可用的组件按目录处理;不保证目标存在。 |
-f 输出规范绝对路径
readlink -f /srv/current/config.yml
此例要求 /srv/current 等中间组件能解析为目录。结果会处理符号链接、.、.. 和重复斜杠;是否允许最后名称缺失,要针对解析后的路径理解,不是简单拼接原最后名称。
-e 要求最终目标也存在
readlink -e /srv/current/config.yml
目标配置文件也必须能解析。不存在或不可用时失败,但成功不代表文件一定可读,更不防止检查与实际打开之间被替换。
-m 允许缺失的中间组件
readlink -m /srv/future/../uploads/new-file.txt
没有现有链接改变布局时,可得到 /srv/uploads/new-file.txt。-m 仍可能解析遇到的现有链接,不是完全不访问文件系统的纯字符串处理;也不保证输出位置可创建。一般规范化和相对路径计算可参照 realpath 的存在条件与输出模式。
多个链接与输出分隔
保持输入与输出的对应关系
当这三个链接已经存在时,GNU 可以一次读取:
readlink current previous config-link
每个成功项目默认输出一行。部分输入失败时可能只收到其余成功输出,不能简单按行号与原输入一一对应。下面逐个显示链接名,失败项目跳过:
for link in current previous config-link; do
target=$(readlink -- "$link") || continue
printf '%s -> %s\n' "$link" "$target"
done
循环中的 continue 明确选择跳过失败,因此它不是“所有链接都成功”的汇总检查。需要完整清单时应另行记录错误并决定整体退出状态。命令替换还会删除末尾换行,不适合无损保存目标字符串本身以换行结尾的特殊情况。
-n 与 -z 的区别
-n 或 --no-newline 对单个结果省略末尾分隔符:
readlink -n current
GNU 对多个输入与 -n 同用会发出警告;不要依靠拼在一起的可见文本分辨项目。-z 或 --zero 则让每项以 NUL(值为零的字节)结束:
readlink -z current previous
接收程序也必须支持 NUL 分隔。这个选项改变输出,不会让 readlink 从标准输入读取路径清单;普通 shell 变量也不能保存 NUL 分隔字节流。最新 GNU 文档还提示,直接输出到终端可能采用 shell 转义引号显示,自动化应按输出模式处理,不能盲目复制显示装饰作为路径内容。
与 realpath、ls、stat 比较
| 命令 | 主要用途 | 选择依据 |
|---|---|---|
readlink |
读取链接保存的目标字符串。 | 默认模式可读取目标已缺失的链接。 |
realpath |
规范路径与相对输出。 | GNU 文档建议一般路径规范化优先使用。 |
ls -l |
给人阅读的链接与目标列表。 | 包含其他列及特殊名称显示,不适合解析目标字符串。 |
stat |
查询链接或目标的元数据。 | 可查看文件类型、inode、权限和时间戳;是否跟随链接取决于选项。 |
需要目标字符串用 readlink;需要最终规范路径用 realpath;需要判断链接或目标的元数据可查看 stat 的查询与链接处理。不要把列表中的箭头分隔符当作永远可靠的自动化格式,因为文件名本身也可能含有类似文本。
脚本中识别路径与处理失败
独立判断保存的目标是相对还是绝对路径
将下面代码保存为 inspect-link.sh,用 sh inspect-link.sh "链接路径" 调用。依赖本机 readlink,输入应是可读取的符号链接;没有恰好一个参数时返回状态 2,读取失败返回状态 1:
if [ "$#" -ne 1 ]; then
printf '%s\n' '用法:sh inspect-link.sh 符号链接路径' >&2
exit 2
fi
link=$1
target=$(readlink -- "$link") || {
printf '%s\n' '无法读取符号链接。' >&2
exit 1
}
case "$target" in
/*) printf '%s\n' '保存的是绝对路径。' ;;
*) printf '%s\n' '保存的是相对路径。' ;;
esac
这里判断的是链接保存的字符串是否以 Unix 根斜杠开头,不是检查最终目标是否存在、可读或位于允许目录内。相对目标必须从链接所在目录解释;不能直接拼到当前工作目录。任意名称末尾换行的限制也适用于这里的命令替换。
显式检查退出状态
如果已经设置好 link,可以改用以下分支读取并打印目标;发生读取错误时打印含链接名的诊断并退出:
if target=$(readlink -- "$link"); then
printf '%s\n' "$target"
else
printf '无法读取链接:%s\n' "$link" >&2
exit 1
fi
检查命令状态比只判断输出是否为空更明确。脚本若选择继续运行或跳过错误,应明确处理策略;不要用后续 printf 的成功掩盖 readlink 失败。
主要选项速查
| 选项 | 用途 |
|---|---|
-f、--canonicalize |
规范路径;仅最后名称可缺失。 |
-e、--canonicalize-existing |
所有组件必须存在;末尾斜杠要求目录。 |
-m、--canonicalize-missing |
缺失或不可用组件按目录处理。 |
-n、--no-newline |
单个输入省略结果末尾分隔符。 |
-z、--zero |
每项结果以 NUL 结束。 |
-q、-s、--quiet、--silent |
抑制大部分错误消息,不改变失败状态。 |
-v、--verbose |
显示错误消息,便于诊断。 |
GNU 默认是否显示诊断还受 POSIXLY_CORRECT 环境变量影响;需要稳定的错误显示策略时明确指定 -v 或静默选项。POSIX 的基本 readlink 不包含 GNU -f、-e、-m 规范化选项,跨系统脚本应先查本机帮助。
常见问题与排查
没有输出却失败
默认模式下,输入可能不是符号链接,也可能是链接本身不可访问或路径无法解析。查看退出状态,并用 readlink -v -- "链接路径" 获取诊断。普通文件在默认模式失败,与 -f 模式可处理普通文件路径并不矛盾。
相对目标看起来指错位置
先定位链接所在目录,再解释保存的相对字符串。如果移动了链接本身却没保持其与目标的相对关系,链接也可能失效。默认输出不以命令执行位置重新定位。
另一台系统不支持 -f
核对操作系统、readlink 实现和版本。不要因为命令同名就假定 GNU 扩展可用;如果需要规范路径,可比较目标系统的 realpath 及其存在条件选项。
常见问答
readlink 会读取目标文件内容吗?
不会。默认模式读取符号链接保存的目标字符串;规范化模式也只是计算路径。
失效链接还能读出目标吗?
链接本身仍存在且可读取时可以。GNU -e 规范化则要求实际目标也能解析。
怎样从相对目标得到绝对路径?
GNU readlink -f 可以按相应存在条件规范化,但一般路径规范化优先考虑 realpath。只需相对字符串时不必切换模式。
为什么脚本不用 ls -l 解析链接?
ls -l 用于给人看的列表;readlink 专门输出目标,避免解析其他列和含箭头的名称。仍需检查退出状态并选择合适的结果分隔方式。




