Bash变量未加双引号导致文件名含空格解析异常实战案例

一、问题背景

在日常Linux运维、Shell自动化脚本开发中，文件名、目录名包含空格、制表符、特殊符号是常见场景。多数新手编写Bash脚本时，使用变量引用文件路径习惯性省略双引号，看似代码运行正常，一旦遇到带空格的文件名就会出现文件找不到、误删文件、循环遍历错乱等隐蔽BUG。该类错误具备偶发性，无空格文件运行正常，排查难度高，是Bash高频踩坑点。本文结合正反示例代码，还原故障现象、剖析底层原理并给出标准化编码规范。

二、故障复现代码（错误写法）

2.1 环境准备

在测试目录创建带空格名称的测试文件：

bash 复制代码

# 创建测试文件，文件名包含空格
touch "test file.txt" "demo data.log" "my config.json"
# 创建无空格对照文件
touch normal.txt

2.2 错误脚本：变量不加双引号

bash 复制代码

#!/bin/bash
# bad_demo.sh 错误示例：变量引用未添加双引号
file_name="test file.txt"

# 直接无引号调用变量
if [ -f $file_name ];then
    echo "文件存在：$file_name"
else
    echo "文件不存在"
fi

# 遍历当前目录所有文件
for file in $(ls);do
    rm -f $file
    echo "已删除：$file"
done

2.3 运行异常现象

文件判断逻辑：[ -f $file_name ] 被Shell拆分为[ -f test file.txt ]，test作为第一个参数、file.txt作为第二个参数，test不是文件，判定文件不存在，逻辑失效。
循环删除逻辑：$(ls)把带空格文件名按照空格切分成多个字符串，test file.txt被拆成test和file.txt，执行rm -f test，若系统恰好存在test文件会被误删除，造成数据丢失。

三、原理分析

Bash在执行变量替换后会执行单词拆分（Word Splitting），默认以IFS（空格、换行、制表符）作为分隔符，自动切割字符串为多个参数。变量不加双引号时，拆分机制生效；添加双引号后，Shell关闭单词拆分，变量整体作为单个参数传递，完整保留原始空格与特殊字符。

四、修正后标准代码（正确写法）

bash 复制代码

#!/bin/bash
# good_demo.sh 规范示例：变量全部使用双引号包裹
file_name="test file.txt"

# 变量添加双引号，完整保留文件名空格
if [ -f "$file_name" ];then
    echo "文件存在：$file_name"
else
    echo "文件不存在"
fi

# 安全遍历目录，摒弃ls解析，使用glob通配符
for file in ./*;do
    [ -f "$file" ] && echo "待处理文件：$file"
done

运行结果：脚本可精准识别带空格文件名，文件存在校验正常，遍历不会拆分文件名，规避误删风险。

五、延伸拓展场景

除文件路径外，接收用户输入、命令输出赋值变量同样需要加引号：

bash 复制代码

# 接收用户带空格输入
read input_str
# 错误：echo $input_str
# 正确
echo "$input_str"

批量脚本开发规范：所有$变量在使用时统一包裹英文双引号，仅数字运算、数组下标等特殊场景可酌情省略。

六、总结

变量遗漏双引号是Bash入门到进阶持续高频隐患，BUG触发条件依赖带空格文件名，平时测试难以覆盖，上线后极易引发生产故障。养成变量必加双引号、避免for in $(ls)遍历文件的编码习惯，能从源头杜绝此类解析异常问题。

海量精选技术文档和实战案例持续更新，敬请关注【风骏时光少年】公众号