bash中用变量`if [[ -f $foo ]]`检测文件失效的问题排查

问题现象 #

执行touch ~/foo.baz创建文件后，在.bashrc中运行以下代码：

bar='~/foo.baz'

echo "$bar"; ls -l "$bar"

if [[ -f ~/foo.baz ]] # 待重构的原有代码
then
    echo 'A: It works as expected.'
else
    echo "A: The file $bar is not there."
fi

if [[ -f "$bar" ]] # 期望的动态替换代码，但未生效
then
    echo 'B: It works as expected.'
else
    echo "B: The file $bar is not there."
fi

得到的运行结果为：

~/foo.baz
ls: cannot access '~/foo.baz': No such file or directory
A: It works as expected.
B: The file ~/foo.baz is not there.

尝试将[[ ... ]]改为[ ... ]、调整变量引用方式、使用-e替代-f等方法均未解决问题，当前使用GNU bash 5.1.16版本。

原因分析 #

核心问题是单引号阻止了Bash对~的路径扩展：

• 当用bar='~/foo.baz'定义变量时，单引号会将所有内容当作字面量处理，~不会被解析为当前用户的主目录（比如/home/username），变量bar存储的就是字符串~/foo.baz。
• 在[[ -f ~/foo.baz ]]中，~直接写在代码里，Bash会自动将其扩展为主目录路径，因此能正确找到文件。
• 而[[ -f "$bar" ]]执行时，$bar展开后是字面量~/foo.baz，此时Bash不会对这个字符串内部的~进行二次扩展，导致系统找不到对应的文件，ls -l "$bar"报错也是同样的道理。

解决方案 #

方法1：定义变量时让~被直接解析 #

去掉单引号，改用无引号或双引号定义变量，Bash会自动扩展~为主目录路径：

bar=~/foo.baz  # 无引号，直接解析~
# 或者
bar="~/foo.baz"  # 双引号下同样会解析~

修改后bar存储的就是实际的文件路径（比如/home/username/foo.baz），再用[[ -f "$bar" ]]就能正常检测文件。

方法2：扩展已存储的带~的变量 #

如果必须使用单引号定义变量（比如路径包含特殊字符，或从外部获取带~的字符串），可以用eval手动扩展~：

bar='~/foo.baz'
# 扩展~为实际路径
expanded_bar=$(eval echo "$bar")
if [[ -f "$expanded_bar" ]]; then
    echo 'B: It works as expected.'
else
    echo "B: The file $expanded_bar is not there."
fi

⚠️ 注意：eval会执行字符串中的命令，若变量内容来自不可信来源，存在安全风险。

方法3：用$HOME代替~（更可靠） #

$HOME是Bash内置变量，代表当前用户的主目录，在双引号中会被正确解析，用这种方式定义变量更稳定：

bar="$HOME/foo.baz"
# 或者单引号下直接写（无引号也可以）
bar=$HOME/foo.baz

这样无论用哪种引号（单引号除外，单引号下要去掉引号或用双引号包裹$HOME），都能得到正确的文件路径，后续的[[ -f "$bar" ]]检测自然生效。

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