使用Bash列出含空格文件名的目录时出现文件拆分错误的问题

问题场景 #

要获取目录下所有文件名用于后续开发，使用了以下代码：

path="directory"
files=($(ls "$path"))
echo "${#files[@]}"
echo "${files[@]}"

目录下仅存在一个名为file 0的文件，但输出显示数组有2个元素：file和0，空格被当成文件分隔符拆分了。
环境信息：GNU bash 5.1.16(1)-release，Linux Mint 21.1

问题原因 #

ls的输出会被Bash的分词机制处理，默认以空格、制表符、换行符作为分隔符，导致含空格的文件名被拆分成多个数组元素。绝对不要用ls批量处理文件名，这是Bash脚本开发的常见陷阱。

正确解决方案 #

方案1：使用Bash通配符（最推荐） #

利用Bash的文件名通配符展开，会自动保留每个文件名的完整性：

path="directory"
# 匹配目录下所有文件，自动处理含空格的文件名
files=("$path"/*)
# 若只需保留文件名（去掉路径前缀），用参数替换
files=("${files[@]##*/}")

# 验证结果
echo "${#files[@]}"
echo "${files[@]}"

方案2：使用find命令（支持复杂场景） #

如果需要递归遍历、筛选文件类型等复杂操作，用find配合空字符分隔来避免所有分词问题：

path="directory"
# -print0 用空字符分隔文件名，readarray -d '' 以空字符为分隔符读取
readarray -d '' files < <(find "$path" -maxdepth 1 -type f -print0)
# 去掉路径前缀（可选）
files=("${files[@]##*/}")

# 验证结果
echo "${#files[@]}"
echo "${files[@]}"

注意事项 #

• 处理文件名时，必须用双引号包裹变量（如"${files[@]}"），防止分词和路径扩展破坏文件名完整性
• 优先使用Bash内置的通配符展开，简单高效；复杂场景再用find

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