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 输出就能防止路径穿越吗?
不能。权限、目录组件边界与检查之后的路径变化都要另外处理,不能把规范化结果当作安全打开文件的证明。




