Zsh 语法详细总结

Zsh（Z Shell）是一款兼容POSIX标准的Unix Shell，完全兼容Bash基础语法，同时提供了更强大的扩展特性、更灵活的编程能力和更友好的交互体验，是目前主流的交互式Shell和脚本开发环境。本文档系统梳理Zsh核心语法、独有特性及与Bash的关键差异，兼顾入门使用和高级脚本开发。

一、脚本基础与执行规范

1. 脚本声明

脚本首行需指定解释器，推荐两种写法：

#!/usr/bin/env zsh  # 推荐，自动适配zsh路径
#!/bin/zsh          # 固定路径写法

2. 执行方式与核心区别

3. 注释语法

• 单行注释：以#开头，行内#后内容均为注释
  # 这是单行注释
  echo "hello" # 这是行尾注释

• 多行注释：两种常用写法
  # 写法1：单引号包裹（推荐）
  : '
  这是多行注释
  第二行注释
  '
  
  # 写法2：Here Document
  <<'COMMENT'
  这是多行注释
  第二行注释
  COMMENT

4. 引号与转义规则

核心差异：Zsh中未加引号的变量默认不进行IFS单词分割，Bash会默认分割，这是最常见的踩坑点。 示例：var="a b c"; echo $var 在Zsh中视为单个参数，Bash中会拆分为3个参数。

5. 命令替换

将命令的输出赋值给变量或嵌入字符串，推荐使用$()写法，支持嵌套：

# 推荐写法
now=$(date +%Y-%m-%d)
file_count=$(ls *.txt | wc -l)

# 兼容写法（反引号，嵌套需转义）
now=`date +%Y-%m-%d`

二、变量与数据类型

Zsh支持字符串、整数、浮点数、数组、关联数组等数据类型，提供丰富的变量操作能力。

1. 变量定义与基础操作

• 基础赋值：等号两侧不能有空格
  # 普通赋值
  name="zsh"
  version=5.9
  
  # 只读变量（不可修改）
  readonly ROOT_UID=0
  typeset -r ROOT_PATH="/root"
  
  # 导出为环境变量（子进程可访问）
  export PATH="$HOME/bin:$PATH"
  typeset -x JAVA_HOME="/usr/lib/jvm/default-java"

• 变量引用：$var 或 ${var}，复杂场景必须用花括号包裹
  echo "Hello $name"
  echo "Version ${version}_release" # 花括号避免歧义

2. 字符串处理（Zsh核心扩展）

Zsh内置丰富的字符串操作，无需依赖sed/awk/tr等外部命令。

3. 数值运算

Zsh原生支持整数和浮点数运算，这是与Bash的核心差异（Bash仅支持整数，浮点需依赖bc/awk）。

# 整数运算
(( a = 1 + 2 * 3 ))  # a=7
(( a++ ))             # 自增，a=8
(( a-- ))             # 自减，a=7
echo $(( 10 / 3 ))   # 整数除法，输出3

# 浮点数运算（Zsh独有）
(( f = 1.5 + 2.5 ))  # f=4.0
(( pi = 3.1415926 * 2 ))
echo $(( 10.0 / 3 )) # 浮点除法，输出3.3333333333333335

# 显式声明数值类型
typeset -i int_var=10    # 声明整数
typeset -F float_var=3.14 # 声明浮点数

4. 特殊变量与内置变量

5. 变量修饰符与作用域

通过typeset（别名declare）声明变量属性，控制作用域和类型：

三、索引数组（Array）核心语法

Zsh的数组功能远强于Bash，默认索引从1开始（Bash从0开始），支持负索引、灵活切片、自动去重等特性。

1. 数组定义与初始化

# 基础定义（空格分隔元素）
arr=(apple banana cherry)

# 空数组
empty_arr=()

# 带索引赋值
arr[1]="apple"
arr[2]="banana"

# 范围创建
num_arr=( {1..10} )       # 1~10的整数数组
char_arr=( {a..z} )        # a~z的字母数组
seq_arr=( {0..10..2} )     # 步长2，0 2 4 6 8 10

# 声明数组并自动去重
typeset -U unique_arr=(a b a c b) # 最终为(a b c)

2. 数组访问与切片

arr=(apple banana cherry date)

# 单个元素访问（索引从1开始）
echo ${arr[1]}  # apple
echo ${arr[-1]} # date（负索引，最后一个元素）

# 所有元素访问
echo ${arr[@]}  # 所有元素（数组形式，推荐）
echo ${arr[*]}  # 所有元素（单个字符串）

# 切片：${arr[@]:起始位置:长度}
echo ${arr[@]:2:2} # banana cherry（从第2个开始，取2个）
echo ${arr[@]:2}    # 从第2个取到末尾

# 数组长度
echo ${#arr[@]} # 4

3. 数组增删改操作

arr=(a b c)

# 追加元素（Zsh独有简洁写法）
arr+=(d e) # 最终为(a b c d e)

# 修改元素
arr[2]="x" # 最终为(a x c d e)

# 删除元素
unset arr[3] # 删除第3个元素，最终为(a x d e)
arr=(${arr:#x}) # 删除匹配"x"的元素，最终为(a d e)

# 清空数组
arr=()

4. 数组遍历与合并

# 数组合并
arr1=(a b c)
arr2=(d e f)
arr3=(${arr1[@]} ${arr2[@]}) # (a b c d e f)

# 遍历数组（推荐，保留带空格的元素）
for val in "${arr[@]}"; do
  echo "元素：$val"
done

# 带索引遍历
for i in {1..${#arr[@]}}; do
  echo "索引$i：${arr[$i]}"
done

四、关联数组（哈希/字典）语法

Zsh原生支持键值对形式的关联数组，提供比Bash更便捷的遍历和操作能力。

1. 声明与初始化

必须先通过typeset -A/declare -A声明，再进行赋值：

# 声明空关联数组
typeset -A user_map

# 批量赋值（key1 value1 key2 value2）
user_map=(
  name "zhangsan"
  age 20
  shell "zsh"
)

# 单个键值赋值
user_map[email]="zhangsan@example.com"

# 键值对完整写法
user_map=( [name]="lisi" [age]=25 [shell]="bash" )

2. 访问与遍历

typeset -A user_map=(name "zhangsan" age 20 shell "zsh")

# 单个值访问
echo ${user_map[name]} # zhangsan

# 获取所有key
echo ${(k)user_map[@]}  # Zsh原生写法
echo ${!user_map[@]}     # Bash兼容写法

# 获取所有value
echo ${(v)user_map[@]}  # Zsh原生写法
echo ${user_map[@]}      # 简写

# 元素个数
echo ${#user_map[@]} # 3

# 遍历key（通用写法）
for key in "${(k)user_map[@]}"; do
  echo "$key : ${user_map[$key]}"
done

# Zsh独有：直接遍历键值对（无需二次取值）
for key value in "${(@kv)user_map}"; do
  echo "$key -> $value"
done

3. 增删改与存在性判断

typeset -A user_map=(name "zhangsan" age 20)

# 修改值
user_map[age]=21

# 删除键值对
unset user_map[age]

# 判断key是否存在
if [[ -n ${user_map[name]+x} ]]; then
  echo "key存在"
else
  echo "key不存在"
fi

五、流程控制语句

Zsh完全兼容Bash的流程控制语法，同时提供repeat等扩展循环，推荐使用[[ ]]进行条件判断，避免单中括号的语法陷阱。

1. 条件判断：if/elif/else

基础语法

if 条件表达式; then
  # 条件成立执行
elif 条件表达式2; then
  # 条件2成立执行
else
  # 所有条件不成立执行
fi

核心条件表达式

• 双中括号 [[ ]]：Zsh推荐用法，支持通配符、正则匹配，无单词分割问题
• 双括号 (( ))：专用数值比较，支持> < >= <= == != && ||运算符

常用判断符

示例

# 数值判断
num=10
if (( num > 5 )); then
  echo "num大于5"
fi

# 字符串匹配
filename="test.txt"
if [[ $filename == *.txt ]]; then
  echo "是txt文件"
fi

# 正则匹配
str="abc123"
if [[ $str =~ ^[a-z]+[0-9]+$ ]]; then
  echo "格式匹配"
fi

# 文件判断
if [[ -f ~/.zshrc ]]; then
  echo "zsh配置文件存在"
fi

2. 循环语句

for循环（最常用）

# 写法1：遍历列表
for i in {1..5}; do
  echo "数字：$i"
done

# 写法2：C语言风格
for (( i=0; i<5; i++ )); do
  echo "数字：$i"
done

# 写法3：遍历文件
for file in *.txt; do
  echo "处理文件：$file"
done

while循环

条件为真时循环执行：

i=1
while (( i <= 5 )); do
  echo "数字：$i"
  ((i++))
done

# 逐行读取文件
while read -r line; do
  echo "行内容：$line"
done < file.txt

until循环

条件为假时循环执行（与while相反）：

i=1
until (( i > 5 )); do
  echo "数字：$i"
  ((i++))
done

repeat循环（Zsh独有）

固定循环次数，语法更简洁：

# 重复执行5次
repeat 5; do
  echo "hello zsh"
done

循环控制符

• break：跳出当前整个循环
• continue：跳过本次循环，进入下一次循环
• return：函数内返回
• exit：退出整个脚本

3. case分支语句

支持多模式匹配、通配符，Zsh扩展支持分支穿透：

case $var in
  pattern1)
    # 匹配pattern1执行
    ;; # 终止分支
  pattern2|pattern3)
    # 匹配pattern2或pattern3执行
    ;& # 穿透：继续执行下一个分支的代码（不判断匹配）
  pattern4)
    # 上一个分支使用;&，会执行到这里
    ;| # 继续匹配下一个模式
  *)
    # 默认分支，所有模式不匹配时执行
    ;;
esac

示例：

read -r -p "输入一个字母：" char
case $char in
  [a-z])
    echo "小写字母"
    ;;
  [A-Z])
    echo "大写字母"
    ;;
  [0-9])
    echo "数字"
    ;;
  *)
    echo "其他字符"
    ;;
esac

六、函数定义与使用

Zsh支持多种函数定义语法，提供灵活的参数传递、作用域控制和返回值机制。

1. 函数定义语法

支持3种兼容写法，功能完全一致：

# 写法1：推荐，兼容Bash
function func_name() {
  # 函数体
  echo "hello function"
}

# 写法2：Zsh简洁写法
func_name() {
  echo "hello function"
}

# 写法3：无括号写法
function func_name {
  echo "hello function"
}

2. 参数传递与接收

函数内的位置参数与脚本一致，调用时直接在函数名后加参数：

# 定义加法函数
add() {
  echo "参数个数：$#"
  echo "第一个参数：$1"
  echo "第二个参数：$2"
  (( sum = $1 + $2 ))
  echo "和：$sum"
}

# 调用函数
add 1 2

3. 返回值与结果接收

• return：只能返回0~255的整数退出码，0代表成功，非0代表失败
• 字符串/数值结果：通过echo输出，用$()接收返回值

# 退出码返回
is_even() {
  (( $1 % 2 == 0 ))
  return $? # 返回判断结果的退出码
}

if is_even 4; then
  echo "是偶数"
fi

# 通用结果返回
get_greeting() {
  local name=$1
  echo "Hello, $name" # 输出结果
}

# 接收返回值
greeting=$(get_greeting "zsh")
echo $greeting # 输出 Hello, zsh

4. 变量作用域

• 全局变量：函数外定义的变量，函数内可直接访问和修改
• 局部变量：函数内用local/typeset声明，仅在函数内生效，避免污染全局
• 全局声明：函数内用typeset -g声明全局变量

global_var="全局变量"

test_scope() {
  local local_var="局部变量"
  typeset -g new_global="函数内声明的全局变量"

  global_var="修改后的全局变量"
  echo $local_var
}

test_scope
echo $global_var  # 正常输出
echo $new_global   # 正常输出
echo $local_var    # 空，局部变量外部无法访问

5. 高级特性

• 匿名函数：Zsh支持直接执行匿名函数
  () {
    echo "匿名函数执行"
    local temp="临时变量"
  }

• 递归调用：函数支持递归
  # 阶乘函数
  factorial() {
    (( $1 <= 1 )) && echo 1 && return
    echo $(( $1 * $(factorial $(( $1 - 1 ))) ))
  }
  factorial 5 # 输出120

七、重定向与管道

Zsh完全兼容Bash的重定向语法，同时提供扩展管道、进程替换等高级特性。

1. 标准IO重定向

Linux系统默认3个IO流：stdin(0，标准输入)、stdout(1，标准输出)、stderr(2，标准错误)。

示例：

# 正常输出写入文件，错误输出打印到终端
echo "hello" > output.log

# 错误输出写入文件，正常输出打印到终端
ls non_exist_file 2> error.log

# 所有输出都写入文件
ls &> all_output.log

2. 管道与扩展管道

• 基础管道：command1 | command2，将command1的stdout传递给command2的stdin
  # 统计txt文件数量
  ls *.txt | wc -l
  # 筛选包含zsh的进程
  ps aux | grep zsh

• 扩展管道（Zsh独有）：command1 |& command2，将stdout+stderr同时传递给command2，等同于Bash的2>&1 |
  # 同时筛选正常输出和错误输出
  ls non_exist_file |& grep "No such"

3. 进程替换

将命令的输入/输出模拟为临时文件，解决管道无法传递多文件的问题：

• <(command)：将command的输出作为可读文件
• >(command)：将command的输入作为可写文件

# 对比两个目录的文件列表
diff <(ls dir1) <(ls dir2)

# 将输出同时传递给多个命令
echo "hello world" > >(grep hello) > >(wc -l)

4. 多行输入

• Here Document：多行文本输入，常用于脚本中生成配置文件
  # EOF为结束符，单引号包裹EOF会禁用变量解析
  cat > test.txt << 'EOF'
  第一行内容
  第二行内容，$var不会被解析
  第三行内容
  EOF

• Here String：单行字符串输入，将字符串作为stdin传递给命令
  # 等同于 echo "hello zsh" | grep zsh
  grep zsh <<< "hello zsh"

八、Zsh核心利器：通配符与扩展（Globbing）

通配符是Zsh最强大的特性之一，默认开启扩展通配符，支持递归匹配、排除匹配、文件属性过滤等，远超Bash的能力。

1. 基础通配符

2. 扩展通配符（默认开启）

3. 全局限定符（Glob Qualifiers，Zsh独有）

Zsh独有的语法，在通配符后加(限定符)，可按文件类型、大小、时间、权限等精准过滤，无需结合find命令。

常用限定符速览

实用示例

# 递归查找所有普通txt文件
ls **/*.txt(.)

# 查找当前目录大于100MB的文件
ls *(Lm+100)

# 查找最近7天内修改过的php文件
ls **/*.php(mtime-7)

# 查找最近修改的5个文件
ls *(om[1,5])

# 只列出当前目录的子目录
ls -d *(/)

# 递归查找所有隐藏文件
ls **/*(D)

# 查找当前目录所有空文件并删除
rm *(L0)

4. 模式修饰符

用于调整匹配规则，常用：

• (#i)：不区分大小写匹配
  # 匹配hello.txt、HELLO.TXT、Hello.Txt等
  [[ "Hello.txt" == (#i)hello.txt ]]
  ls (#i)*.txt

• (#b)：开启分组捕获，配合正则使用
  [[ "abc123" == (#b)([a-z]*)([0-9]*) ]]
  echo $match[1] # abc
  echo $match[2] # 123

九、别名与快捷键

Zsh提供3种别名类型，远超Bash的普通别名，同时支持丰富的快捷键自定义。

1. 别名分类与定义

普通别名

与Bash完全兼容，仅在命令开头生效，常用于简化长命令：

# 定义别名
alias ll='ls -lAh'
alias gs='git status'
alias grep='grep --color=auto'

# 取消别名
unalias ll

# 查看所有别名
alias

全局别名（Zsh独有）

用alias -g定义，在命令行任意位置都生效，常用于简化管道、重定向等固定片段：

# 定义全局别名
alias -g G='| grep'
alias -g L='| less'
alias -g H='--help'
alias -g N='&> /dev/null'

# 使用示例
ps aux G zsh # 等同于 ps aux | grep zsh
cat file.log L # 等同于 cat file.log | less
ls non_exist N # 等同于 ls non_exist &> /dev/null

后缀别名（Zsh独有）

用alias -s定义，绑定文件后缀与打开程序，输入文件名直接用指定程序打开：

# 定义后缀别名
alias -s txt='vim'
alias -s md='typora'
alias -s py='python3'
alias -s zip='unzip -l'

# 使用示例
test.txt   # 直接用vim打开test.txt
script.py  # 直接用python3执行script.py

2. 常用内置快捷键

Zsh默认使用Emacs按键模式，可通过bindkey -v切换为Vi模式，bindkey -e切回Emacs模式。

十、正则表达式与模式匹配

Zsh内置正则匹配能力，无需依赖外部命令，支持扩展正则语法和分组捕获。

1. 基础正则匹配

使用[[ str =~ regex ]]语法进行正则匹配，匹配成功返回0，失败返回非0：

# 匹配手机号
phone="13812345678"
if [[ $phone =~ ^1[3-9][0-9]{9}$ ]]; then
  echo "手机号格式正确"
fi

# 匹配邮箱
email="test@example.com"
if [[ $email =~ ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$ ]]; then
  echo "邮箱格式正确"
fi

2. 匹配结果捕获

Zsh会自动将匹配结果存入内置变量：

• $MATCH：匹配到的完整字符串
• $match：数组，存储分组捕获的内容
• $MBEGIN/$MEND：匹配内容的起始/结束位置

示例：

str="name:zhangsan,age:20"
if [[ $str =~ name:([a-z]+),age:([0-9]+) ]]; then
  echo "完整匹配：$MATCH"
  echo "姓名：$match[1]"
  echo "年龄：$match[2]"
fi

3. 扩展正则配置

• 开启扩展正则：setopt EXTENDED_REGEX
• 关闭大小写敏感：setopt NO_CASE_GLOB

十一、脚本选项与调试

Zsh通过setopt/unsetopt开启/关闭选项，对应Bash的set/shopt，用于控制脚本行为、错误处理和调试。

1. 核心脚本选项

脚本开头推荐配置，提升脚本健壮性：

#!/usr/bin/env zsh
# 推荐生产环境配置
setopt ERR_EXIT       # 命令执行失败时立即退出脚本（等同于set -e）
setopt NO_UNSET       # 使用未定义变量时报错（等同于set -u）
setopt PIPE_FAIL      # 管道中任意命令失败，整个管道退出码为失败
setopt NO_NOMATCH     # 通配符匹配不到文件时，保留原字符串，不报错

2. 脚本调试方法

# 方式1：命令行直接调试执行
zsh -x script.zsh

# 方式2：脚本内开启/关闭调试
set -x # 开启调试
# 要调试的代码段
set +x # 关闭调试

3. 退出码与错误处理

• 脚本退出：exit N，N为退出码（0=成功，1~255=错误）
• 错误捕获：使用||处理命令失败场景
  # 命令失败时执行兜底逻辑
  ls non_exist_file || echo "文件不存在"
  # 命令失败时直接退出
  cd /data || exit 1

十二、环境配置文件加载规则

Zsh的配置文件分全局配置（/etc下）和用户配置（~下），按Shell类型不同，加载顺序不同。

1. 配置文件加载顺序

2. 核心配置文件适用场景

十三、Zsh与Bash核心语法差异对照表

十四、常用参数扩展修饰符速览

Zsh提供丰富的参数扩展修饰符，用于快速处理变量内容，无需外部命令：