如何正确引用本地Bash文件？解决Shellcheck SC1091报错方案

当你用source ../<local-bash-file>.sh触发SC1091错误，又没法在构建触发器里加shellcheck -x参数时，试试这几个可行的方案：

1. 给Shellcheck添加源文件路径注释 #

直接在source语句上方加一条Shellcheck专属注释，明确指定要跟踪的文件路径，不用-x参数也能让Shellcheck识别并检查该文件：

# shellcheck source=../utils.sh
source ../utils.sh

把../utils.sh换成你实际要引用的文件路径即可，这个注释是Shellcheck的特殊指令，会强制它读取对应文件做静态检查。

2. 基于脚本自身位置生成绝对路径 #

如果脚本可能在不同工作目录下执行，相对路径容易出问题，同时给Shellcheck补全绝对路径注释：

# 获取当前脚本所在的绝对目录
SCRIPT_DIR=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" &>/dev/null && pwd)
# shellcheck source=/project-root/path/to/utils.sh
source "$SCRIPT_DIR/../utils.sh"

注释里的/project-root/path/to/utils.sh换成目标文件的实际绝对路径，或者项目根目录下的相对路径，Shellcheck会根据这个路径去扫描文件。

3. 临时禁用SC1091规则（不推荐用于自有脚本） #

如果目标文件是外部依赖或不需要静态检查，直接在source行末尾加注释禁用该错误：

source ../utils.sh # shellcheck disable=SC1091

注意：这个方法会跳过该条source语句的检查，可能错过目标文件里的潜在问题，只适合应急或非自有脚本场景。

内容的提问来源于stack exchange，提问作者Usama Ijaz