Linux realpath 命令:解析绝对路径、符号链接与相对路径

realpath将指定路径规范化,通常输出处理了相对路径、点组件、重复斜杠和符号链接后的绝对路径。路径必须存在到什么程度由 -e、-E、-m 决定;需要相对结果时可用 GNU 的 --relative-to 或 --relative-base。

它只计算并输出路径,不会替你打开文件、授予访问权限或建立安全沙箱。先明确要查询真实目标、预先计算未来路径,还是生成相对于某个目录的名称,再选择选项。

realpath 解决什么问题?

普通的相对路径依赖当前工作目录,还可能包含 .、.. 和符号链接。realpath 按选定规则计算这些组成部分:

realpath ./docs/../images/logo.webp

假设工作目录是 /home/user/project,沿途需要的目录存在且没有改变解析结果的符号链接,可能输出:

/home/user/project/images/logo.webp

这是带条件的输出示意,不是保证所有机器都有该目录。默认 GNU 模式下,最后名称可以不存在,但此前组件必须能解析为已存在目录;例如 docs 不能仅因后面有 .. 就忽略其存在条件。

基本语法与调用条件

realpath [options] file...

方括号与 file... 是语法占位符。GNU 接受多个路径并逐项输出;每个含空格的路径都应作为独立参数加引号。以下命令分别查询当前目录、相对路径和含冗余组件的绝对路径:

realpath .
realpath ../logs/app.log
realpath /var//log/./nginx/../syslog

后两次调用的中间目录必须满足当前模式的存在条件,不能假定 ../logs 或 /var/log/nginx 总是存在。只查询当前工作目录的物理位置时,pwd -P 更直接;realpath 可处理其他指定路径。

先用 realpath --help、realpath --version 确认本机实现。POSIX.1-2024(可移植操作系统接口规范)规定 realpath [-E|-e] file;旧系统或较旧 GNU 版本可能没有显式 -E,而 GNU 多路径、-m 和相对输出等扩展不能假定在所有 Unix 实现中都存在。

选择路径存在条件

先区分“必须已存在的目标”和“还未创建的名称”。三种模式的差异如下:

选项 成功所需条件
-E、--canonicalize 允许解析后的最后组件不存在;此前路径必须能解析为已存在目录。当前 GNU 默认采用这一存在性规则。
-e、--canonicalize-existing 包括最后目标在内的所有组件都必须存在并可解析。
-m、--canonicalize-missing 缺失或不可用的组件按目录处理,可计算尚不存在的中间路径;不保证目标存在。

-e:要求目标已存在

realpath -e /etc/passwd
realpath --canonicalize-existing /srv/app/config.yml

这两个示例分别要求 /etc/passwd 和 /srv/app/config.yml 能被完整解析;没有这些对象或无法访问沿途目录时会失败。路径末尾有斜杠时还要求目标是目录。使用 -e 不代表已经检查目标一定是普通配置文件,也不能保证之后打开时对象没有变化。

-E:允许最后名称尚未创建

realpath -E /srv/uploads/new-file.txt

此例要求 /srv/uploads 等父路径可解析,但 new-file.txt 可以还不存在。符号链接会先被展开,再按解析后的路径判断条件,所以它不是简单地把最后输入名称拼到父路径后面。

GNU 默认存在性规则允许最后名称缺失,但 POSIX 不统一规定无选项时的行为。需要可移植语义时明确写 -e 或 -E,并确认目标版本支持;遇到“无效选项”应先核对本机帮助,不能把默认行为当作所有平台相同。-E 不会把权限错误、非目录组件等其他解析问题一概当作正常。

-m:计算不存在的中间路径

realpath -m /srv/not-created/../future/file.txt

如果没有改变解析的现有链接,结果可为 /srv/future/file.txt。-m 将缺失或不可用的组件按目录处理,但仍可能解析遇到的现有符号链接;它不是纯字符串模式,更不保证最终路径能够创建或访问。

符号链接与 -P、-L、-s

路径中同时出现链接和 .. 时,处理顺序会改变结果:

选项 处理方式
-P、--physical 遇到符号链接先解析,再处理其后的 ..;GNU 默认模式。
-L、--logical 先在路径中处理后续的 ..,再解析剩余的符号链接。
-s、--strip、--no-symlinks 不解析符号链接;整理点组件和多余斜杠。存在性要求仍由所选模式决定。

物理模式与逻辑模式会如何不同?

realpath -P /srv/current/../shared

例如 /srv/current 是指向 /opt/releases/app1 的符号链接,且沿途及所需目录满足存在条件,物理模式会先到链接目标,再计算父目录,因此可能得到 /opt/releases/shared;对同一路径改用 -L,会先按输入层级处理 current/..,可能得到 /srv/shared。

这是解释模式差异的链接布局示意,不会创建部署目录。所谓“逻辑模式”仍会解析最终保留下来的链接,不等于完全不跟随链接。

用 -s -m 只整理路径字符串

realpath -s -m /srv/current/../shared

这组 GNU 选项不会为了计算而解析实际文件系统中的符号链接,示例得到 /srv/shared。它适合预计算字符串;需要实际目标位置时不能拿这个结果代替物理解析。单独的 -s 不等于自动取消所有存在条件,应把它与 -m 的作用分开理解。

输出相对于指定目录的路径

--relative-to:相对于一个基准输出

realpath --relative-to=/srv/www /srv/www/assets/css/site.css

在路径满足默认存在条件且没有链接改变布局时,输出:

assets/css/site.css

基准目录与目标路径都要按存在性选项处理。目标不在基准内时,结果可以包含 ..,例如需要返回上层再进入其他目录;这个选项不是“只允许访问基准目录以内”的限制器。

--relative-base:只把基准内的路径相对化

realpath --relative-base=/srv/www /srv/www/index.html /var/log/syslog

在这些目录满足存在条件、没有链接改变归属的情况下,第一项输出 index.html,第二项保留绝对路径 /var/log/syslog。它改变显示方式,不拒绝基准外的目标。

GNU 还允许同时使用两项:只有目标在 --relative-base 下,才相对于 --relative-to 输出;否则输出绝对路径。按 GNU 官方用法,relative-to 的基准还须位于 relative-base 的目录范围内,否则也输出绝对路径。不要把这类显示规则误作访问控制。

与 readlink -f 的区别

比较项 realpath readlink -f
主要用途 规范化指定文件名,并可生成相对路径。 在 readlink 工具中启用路径规范化模式。
输出方式 GNU 支持 relative-to、relative-base 等相对输出选项。 GNU 的 -f 通常输出绝对规范路径。
选择依据 GNU 文档建议路径规范化优先使用 realpath。 不加 -f 的 readlink 主要读取链接中保存的目标字符串。
可移植性 确认版本、选项和默认存在条件。 不能假定所有 Unix 实现都支持相同 -f 行为。

不要把单独的 readlink 与 readlink -f 混为一谈。前者可以输出链接中保存的相对目标字符串,后者按相应实现的规则做规范化;处理缺失名称时,仍须核对具体选项和实现。

脚本中记录路径与分隔多个结果

一个可独立运行的配置路径示例

将下面代码保存为 resolve-config.sh,使用 sh resolve-config.sh "/path/to/config.yml" 调用。需要本机提供 realpath,输入应是你要查询的配置路径。没有提供恰好一个参数时输出用法并以状态 2 退出;解析失败以状态 1 退出;成功打印规范路径:

if [ "$#" -ne 1 ]; then
 printf '%s\n' '用法:sh resolve-config.sh 配置文件路径' >&2
 exit 2
fi

config=$(realpath -e -- "$1") || {
 printf '%s\n' '无法解析配置文件路径。' >&2
 exit 1
}

printf '配置文件:%s\n' "$config"

示例只查询路径,不读取配置内容。-e 不要求对象一定是普通文件或对后续读取可用,若程序确有这类要求,需要另外检查和处理实际打开操作的结果。双引号避免单词拆分,-- 结束选项解析,两者都应保留。

-z:输出 NUL 分隔结果

realpath -z -- file1 "file with space"

在当前目录可解析、两个最后名称符合所用模式时,命令逐项输出它们的路径,每项末尾是 NUL 字节,适合把可能含换行的名称传给支持 NUL 输入的程序。它不会因此从标准输入读取路径清单。

普通 shell 变量不能用来保存 NUL 输出。上面的 config=$(...) 使用默认换行输出,也会去掉末尾换行,因此不是无损处理任意特殊名称的通用协议。最新 GNU 文档还说明,标准输出直接连接终端时可能采用 shell 转义引号显示;程序应按实际输出模式和版本处理,不能把终端上看到的装饰引号盲目当作文件名的一部分。

路径规范化的安全边界

规范化不会授予权限

一个路径看起来位于允许的目录内,不代表当前进程有读写权限。所有权、普通权限、访问控制列表(ACL)与系统安全策略仍然分别生效;-m 的成功输出尤其不能证明访问一定成功。

检查和使用之间可能发生变化

realpath 返回后,到程序实际打开文件之前,其他进程仍可能替换目录或符号链接。这类检查与使用之间的时间差,不能靠缓存一条规范路径来消除。安全边界需要合适的文件打开方式与最小权限,不能只依赖字符串比较。

字符串前缀不等于目录包含关系

/srv/www-safe 也以字符串 /srv/www 开头,却不是它的子目录。判断归属时至少要考虑完整目录组件及根路径本身,同时仍要处理实际打开时的变化;realpath 和 relative-base 都不会自动建立沙箱。

主要选项速查

选项 用途与条件
-E、--canonicalize 允许解析后的最后名称缺失;父路径仍须能解析。
-e、--canonicalize-existing 所有组件必须存在;末尾斜杠要求目录。
-m、--canonicalize-missing 缺失或不可用的组件按目录处理。
-L、--logical 先处理后续 ..,再解析保留的符号链接。
-P、--physical 遇到链接先解析;GNU 默认模式。
-s、--strip、--no-symlinks 不解析符号链接;与 -m 合用可只计算字符串。
--relative-to=目录 相对于该基准输出;目标可在基准外。
--relative-base=目录 基准内目标用相对路径,基准外保留绝对路径。
-q、--quiet 抑制指定路径的诊断消息;不把失败变成成功。
-z、--zero 每项结果以 NUL 字节结束。

GNU 有任一路径未能正常输出时整体返回非零状态,但多路径调用可能已输出其他成功项。需要完整清单时应检查状态,不能只凭收到部分输出就认定全部路径已验证。

常见问答

文件不存在也能使用 realpath 吗?

可以按意图选择:当前 GNU 默认规则或 -E 允许最后名称缺失,-m 可处理缺失的中间组件,-e 则要求全部存在。还须确认本机支持对应选项。

realpath 总会跟随符号链接吗?

默认物理模式会解析链接。-L 也会解析保留的链接,只是与 .. 的处理顺序不同;不跟随链接要用 -s,需要纯字符串计算可与 -m 合用。

pwd -P 与 realpath . 有什么区别?

两者可显示当前目录的物理绝对路径。pwd -P 专门查询当前工作目录;realpath 还能处理其他路径、存在条件和 GNU 相对输出。

只检查 realpath 输出就能防止路径穿越吗?

不能。权限、目录组件边界与检查之后的路径变化都要另外处理,不能把规范化结果当作安全打开文件的证明。

参考资料