如何用shell获取当前执行脚本的绝对路径？

Question

在Shell脚本开发中，常需获取当前执行脚本的绝对路径，以便进行文件引用或日志输出。一个常见问题是：当使用 `./script.sh` 或通过软链接执行脚本时，`$0` 的值可能为相对路径或符号链接路径，导致 `pwd` 或 `dirname $0` 无法正确解析真实路径。如何可靠地获取脚本的绝对路径并消除符号链接影响？

Answer 1

Shell脚本中获取真实绝对路径的深度解析

1. 问题背景与常见误区

在Shell脚本开发中，获取当前执行脚本的绝对路径是一个基础但极易出错的操作。开发者常依赖$0变量来定位脚本位置，并结合dirname $0或pwd进行路径拼接。然而，当脚本通过相对路径（如./script.sh）或符号链接调用时，$0返回的是相对路径或链接路径，而非实际文件所在的真实路径。

例如：

#!/bin/bash
echo "原始 \$0 值: $0"
echo "dirname \$0: $(dirname $0)"

若从软链接/usr/local/bin/myapp指向/opt/app/v1/script.sh执行，则上述输出可能为：dirname $0: /usr/local/bin，显然不是期望结果。

2. 深入分析：$0 的行为与局限性

• $0 是调用方式决定的：它反映的是用户如何调用脚本，而非脚本物理位置。
• pwd 不可靠：仅返回当前工作目录，与脚本位置无关。
• dirname $0 可能是相对路径：如./、../bin等，需进一步处理。
• 符号链接导致路径偏移：使用ln -s创建的快捷方式会误导路径解析逻辑。

3. 解决方案演进路径

阶段	方法	优点	缺点
初级	$(dirname $0)	简单直接	无法处理相对路径和软链
中级	realpath $(dirname $0)	解决软链问题（需GNU coreutils）	macOS默认不支持realpath
高级	readlink -f $0	跨平台兼容性较好，解析完整路径	部分旧系统不支持-f选项
企业级	组合命令+兼容判断	最大兼容性与鲁棒性	代码复杂度上升

4. 推荐实现：高可靠性路径解析函数

#!/bin/bash

# 获取脚本真实绝对路径（消除符号链接影响）
get_script_dir() {
    local source="$0"
    
    # 处理可能是符号链接的情况
    while [[ -L "$source" ]]; do
        dir="$(cd "$(dirname "$source")" && pwd -P)"
        source="$(readlink "$source")"
        # 若目标为相对路径，补全
        [[ $source != /* ]] && source="$dir/$source"
    done

    # 获取最终目录
    dir="$(cd "$(dirname "$source")" && pwd -P)"
    echo "$dir"
}

SCRIPT_DIR=$(get_script_dir)
echo "脚本真实路径: $SCRIPT_DIR"

5. 跨平台兼容性考量

在macOS或FreeBSD等非Linux系统中，readlink -f可能不可用。此时可采用以下替代方案：

# macOS兼容版本
if [[ "$(uname)" == "Darwin" ]]; then
    # 使用perl或python辅助解析
    SCRIPT_PATH=$(perl -e 'use Cwd "abs_path"; print abs_path(shift)' "$0")
else
    SCRIPT_PATH=$(readlink -f "$0")
fi

6. 流程图：路径解析逻辑

graph TD
    A[开始] --> B{是否为符号链接?}
    B -- 是 --> C[读取链接目标]
    C --> D{目标是否为绝对路径?}
    D -- 否 --> E[拼接当前目录]
    D -- 是 --> F[继续解析]
    E --> F
    F --> G{是否仍为链接?}
    G -- 是 --> C
    G -- 否 --> H[获取dirname并转为绝对路径]
    H --> I[返回真实路径]

7. 实际应用场景举例

• 配置文件加载：基于脚本位置查找同级config/目录。
• 日志路径设定：$SCRIPT_DIR/../logs/app.log确保统一结构。
• 模块化脚本调用：子脚本通过父脚本路径定位自身位置。
• 部署自动化：CI/CD中动态识别项目根目录。
• 资源文件引用：图片、模板、SQL脚本等依赖路径正确性。

8. 安全与边界情况处理

在生产环境中还需考虑：

1. 用户传入-作为$0（来自管道输入）
2. /proc/self/exe是否存在（Linux特有）
3. 权限不足导致readlink失败
4. 循环符号链接风险（应设置最大跳转次数）
5. 多线程或子shell环境下$0变化
6. 容器化环境中的挂载路径差异
7. SELinux/AppArmor限制对路径访问的影响
8. UTF-8路径名或特殊字符兼容性
9. 长路径截断问题（尤其Windows子系统）
10. 不同shell解释器（dash, zsh, fish）的行为差异