怎么用脚本获取脚本自身路径

本文目录导读：

1. 文章标题：脚本的自我认知：如何用脚本精准获取自身路径（Bash/Python/批处理全解析）
2. 第一部分：引言——脚本的“寻根之旅”
3. 第二部分：Bash 脚本——告别 $0 的“假相”
4. 第三部分：Python 脚本——__file__ 的进化论
5. 第四部分：Windows 批处理——经典中的经典 %~dp0
6. 第五部分：跨语言通用方案——环境变量的博弈
7. 第六部分：实战问答（FAQ）
8. 第七部分：总结与最佳实践——让脚本“脚踏实地的定位”

脚本的自我认知：如何用脚本精准获取自身路径（Bash/Python/批处理全解析）

---

目录导读（Table of Contents）

1. 引言：为什么脚本需要知道自己“身在何方”？
2. 核心概念：相对路径 vs. 绝对路径——一场致命的混淆
3. Bash 脚本：$0 的陷阱与 BASH_SOURCE 的救赎
4. Python 脚本：__file__ 的魔法与 os.path.realpath 的终极防御
5. Windows 批处理：%~dp0 的古老智慧
6. 跨语言通用方案：环境变量与 pwd 的组合拳
7. 实战问答（FAQ）：解决90%的路径获取痛点
8. 总结与最佳实践（SEO关键词嵌入）

---

第一部分：引言——脚本的“寻根之旅”

在自动化运维、数据处理或日常开发中，我们经常遇到这样的场景：一个定时任务脚本需要读取同目录下的配置文件，或者一个部署脚本需要根据自身位置拼装资源路径，如果直接使用./config.conf，当脚本被符号链接（Symlink）调用，或者从其他目录通过全路径执行时，脚本会立刻“迷路”——它找不到了自己的“家”。

核心痛点：绝大多数的路径错误，均源于工作目录（Working Directory）与脚本所在目录（Script Directory）的混淆，前者是你在终端里cd到的位置，后者是文件系统里脚本的物理位置。

---

第二部分：Bash 脚本——告别 $0 的“假相”

在Bash中,小白第一反应是用$0，但$0在多数情况下返回的是执行命令时输入的第一个词。

• 如果你执行./script.sh，$0是./script.sh。
• 如果你执行/home/user/script.sh，$0是/home/user/script.sh。
• 如果你执行bash script.sh，$0可能是script.sh。

致命缺陷：如果脚本是通过软链接（例如ln -s）调用的，$0指向的是链接文件位置，而非真实脚本位置。

绝对可靠的Bash解决方案： 使用${BASH_SOURCE[0]}配合cd命令进行物理路径解析。

#!/bin/bash
# 获取脚本真实路径（兼容软链接、相对路径、PATH调用）
SOURCE="${BASH_SOURCE[0]}"
while [ -h "$SOURCE" ]; do # 判断是否为符号链接
  DIR="$(cd -P "$(dirname "$SOURCE")" > /dev/null 2>&1 && pwd)"
  SOURCE="$(readlink "$SOURCE")"
  # 如果链接是相对路径，则基于链接所在目录解析
  [[ $SOURCE != /* ]] && SOURCE="$DIR/$SOURCE"
done
SCRIPT_DIR="$(cd -P "$(dirname "$SOURCE")" > /dev/null 2>&1 && pwd)"
echo "脚本所在目录: $SCRIPT_DIR"

为什么有效：-P参数强制物理路径（不解析），readlink能够挖掘出软链接最深层的真实文件。

---

第三部分：Python 脚本——__file__ 的进化论

在Python中,__file__是内置变量，但不要直接使用它，因为：

• 当使用python script.py时，__file__是script.py（相对路径）。
• 当模块被绝对导入时，__file__可能是相对路径。

推荐的最强姿势：

import os
import sys
def get_script_dir():
    # 获取当前文件的绝对路径
    file_path = os.path.realpath(__file__)
    # 区分打包环境（如PyInstaller）
    if getattr(sys, 'frozen', False):
        file_path = sys.executable
    return os.path.dirname(file_path)
if __name__ == "__main__":
    print(get_script_dir())

进阶说明：使用os.path.realpath会解析所有符号链接，返回最真实的物理路径，对于PyInstaller打包后的exe，__file__会指向临时解压目录（_MEIPASS），这时必须改用sys.executable来获取exe所在位置。

---

第四部分：Windows 批处理——经典中的经典 %~dp0

在CMD或BAT文件中,%0代表脚本自身（包含路径），而%~dp0则是PowerShell和CMD用户最信赖的变量。

@echo off
echo 脚本所在盘符: %~d0
echo 脚本所在完整路径: %~dp0
echo 去掉末尾反斜杠: %~dp0
cd /d "%~dp0"  REM 切换到脚本目录

关键细节：%~dp0末尾自带，如果拼接路径需注意双反斜杠问题，建议使用%~dp0config.ini这种直接拼接方式，对于UNC路径（网络路径），%~dp0可能失效，需用pushd "%~dp0"临时映射盘符。

---

第五部分：跨语言通用方案——环境变量的博弈

在某些边缘场景（如Cron任务、Docker容器启动），脚本路径可能难以捕捉，此时可以反向设置：

• 方案A：在调用脚本前，显式导出环境变量：

  export SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"

• 方案B：利用pwd -P获取逻辑路径：

  pwd -P   # 物理路径，无视符号链接

---

第六部分：实战问答（FAQ）

Q1：为什么我用了dirname $0还是报错？ 答：因为$0如果是相对路径（如./script.sh），dirname $0返回的是，此时务必先cd到该目录再执行pwd，实现方式见上述Bash代码。

Q2：Python脚本被import时，__file__指向什么？ 答：指向模块文件本身，但如果是包内模块，可能包含包路径，建议使用pathlib.Path(__file__).resolve().parent。

Q3：如何防止脚本被软链接调用时路径错乱？ 答：终极思路是放弃依赖$0或__file__的原始值，转而使用readlink -f（Linux）或/usr/bin/realpath。

Q4：在Jenkins或CI/CD中，脚本自身路径如何获取？ 答：CI环境通常将脚本复制到workspace下，直接使用$WORKSPACE环境变量即可，但交叉验证可用pwd。

---

第七部分：总结与最佳实践——让脚本“脚踏实地的定位”

语言/环境	推荐方法	适用场景
Bash	${BASH_SOURCE[0]} + cd -P	所有Linux/macOS脚本
Python	os.path.realpath(__file__)	所有源码运行场景
Python（打包）	sys.executable	PyInstaller/cx_Freeze
Batch/CMD	%~dp0	Windows原生脚本
PowerShell	$PSScriptRoot	PS 3.0以上版本

SEO关键点（自然嵌入）：本文所述方法均经过路径解析与符号链接穿透测试，确保在Python脚本获取当前路径、Bash获取脚本所在目录、cross-platform路径获取等高频搜索词下具备实操价值，记得在处理路径时，永远不要信任pwd，永远不要直接拼接前缀，始终以解析后的绝对路径作为业务逻辑的锚点。

最后一道防线：如果你在编写脚本时发现路径依然不对，请立即检查执行方式，是不是用了sh script.sh而非bash script.sh？因为在sh模式下，${BASH_SOURCE[0]}可能为空，这会直接导致路径获取失败，养成指定解释器的好习惯，就是为脚本穿上了“防弹衣”。

---

（全文完）