单中括号[是外部命令（等价于test），严格遵循POSIX，要求变量必须加引号防空格/空值导致参数错乱；双中括号[[是Bash关键字，语法宽松，支持模式匹配、正则、未加引号的变量安全展开。
直接看行为差异，比查文档更快定位问题。单中括号 [ ] 和双中括号 [[ ]] 表面相似，但底层机制完全不同——一个是命令，一个是关键字。排查时重点观察三类现象：报错信息、变量含空格是否崩、特殊符号是否被当作字面量处理。
看报错类型：too many arguments 还是 syntax error？
遇到报错先盯住错误提示：
-
[: too many arguments—— 典型单括号未引号变量的信号。说明 shell 展开后传给[的参数超过预期，比如[ $file == "a b" ]变成[ a b == "a b" ]，五个词，它只认三或四元结构。 -
syntax error near unexpected token或unary operator expected—— 常见于单括号里变量为空，如[ $1 == "1" ]在没传参时变成[ == "1" ]，缺少左操作数。 - 双括号几乎不报这类错。空变量、含空格、甚至写
[[ $x == a* ]]都能安全运行，语法解析更宽松。
试变量含空格：不加引号能不能过？
这是最快速的现场验证法：
- 设
name="hello world" - 执行
[ $name = "hello world" ] && echo ok→ 报错too many arguments - 执行
[[ $name = "hello world" ]] && echo ok→ 安静输出ok - 再试
[ "$name" = "hello world" ]→ 也能过，但多了一对引号，易漏、难维护。
查通配和正则：= 后面能不能用 * ? [ ]？
双括号支持模式匹配，单括号不支持（除非用 case 或外部工具）：
-
[[ abc == a* ]] && echo match→ 成功 -
[ abc = a* ] && echo match→ 不匹配，因为=在单括号里是字面比较，a*不展开也不通配 -
[[ abc =~ ^a.*$ ]] && echo regex→ 支持正则（仅双括号） -
[ abc =~ ^a.*$ ]→ 直接语法错误，单括号根本不认识=~
确认 shell 类型和兼容性需求
不是所有 shell 都有 [[ ]]：
- 在脚本开头写
#!/bin/bash或#!/usr/bin/env bash，才能放心用双括号 - 如果必须跑在 POSIX shell（如
/bin/sh）下，只能用单括号，且必须严格遵守：[ "$var" = "val" ]、[ -n "$var" ]、[ -f "$path" ] - 检查当前 shell：
echo $0或ps -p $$；确认是否 Bash：echo $BASH_VERSION
