Zenity：Linux 命令行下的 GUI 交互神器详解

目录#

1. 安装 Zenity
2. 基本用法与核心对话框类型
3. 高级特性
4. 常见实践场景
5. 最佳实践
6. 实战脚本示例
- 6.1 系统信息收集工具
- 6.2 照片整理助手
7. 故障排除
8. 总结
9. 参考资料

1. 安装 Zenity#

Zenity 通常预安装在基于 GNOME 的 Linux 发行版中，若未安装，可通过以下命令快速部署：

发行版	安装命令
Debian/Ubuntu	`sudo apt install zenity`
Fedora/RHEL	`sudo dnf install zenity`
Arch Linux	`sudo pacman -S zenity`
openSUSE	`sudo zypper install zenity`

验证安装：

zenity --version  # 输出类似：3.42.1

2. 基本用法与核心对话框类型#

Zenity 的基本语法为：

zenity [选项]

通过不同的选项，可生成多种对话框。以下是最常用的类型及示例：

2.1 消息对话框（Message Dialog）#

用于显示信息、警告、错误或询问用户确认，支持 --info（信息）、--warning（警告）、--error（错误）、--question（询问）四种类型。

常用选项：

--text "内容"：对话框文本
--title "标题"：窗口标题
--width N/--height N：自定义尺寸（像素）

示例 1：信息提示

zenity --info --title "欢迎" --text "这是一个 Zenity 信息对话框示例！" --width 300

示例 2：询问确认（获取用户选择）

if zenity --question --title "确认" --text "是否继续执行？" --width 250; then
  echo "用户选择：继续"
else
  echo "用户选择：取消"
fi

说明：--question 对话框返回 exit code：0（确定）、1（取消），可通过 $? 获取。

2.2 输入对话框（Entry Dialog）#

用于收集用户文本输入（如用户名、密码），通过 --entry 启用。

常用选项：

--entry-text "默认文本"：预设输入框内容
--hide-text：隐藏输入内容（密码场景）

示例：获取用户输入并保存

username=$(zenity --entry \
  --title "用户输入" \
  --text "请输入用户名：" \
  --entry-text "guest" \
  --width 300)
 
# 处理用户取消（exit code 1）
if [ $? -eq 1 ]; then
  zenity --error --text "操作已取消" --width 200
  exit 1
fi
 
echo "用户名：$username"

密码输入示例：

password=$(zenity --entry --title "密码输入" --text "请输入密码：" --hide-text --width 300)

2.3 文件选择对话框（File Selection Dialog）#

用于让用户选择文件或目录，通过 --file-selection 启用。

常用选项：

--directory：仅允许选择目录
--save：保存模式（提示覆盖确认）
--multiple：允许选择多个文件
--file-filter "描述 | 模式"：过滤文件类型（如 *.txt）

示例 1：选择单个文件

file_path=$(zenity --file-selection --title "选择文件" --file-filter "文本文件 | *.txt" --width 600)
echo "选中文件：$file_path"

示例 2：选择目录

dir_path=$(zenity --file-selection --directory --title "选择目录" --width 600)

2.4 列表对话框（List Dialog）#

用于从列表中选择选项，支持单选（--radiolist）或多选（--checklist）。

核心选项：

--list：启用列表模式
--column "列名"：定义列表列（至少一列）
--radiolist：单选模式（默认选项前加 TRUE/FALSE）
--checklist：多选模式（默认选项前加 TRUE/FALSE）

示例 1：单选列表（选择操作系统）

os=$(zenity --list --radiolist \
  --title "选择系统" \
  --text "你使用的 Linux 发行版是？" \
  --column "选择" --column "发行版" \
  TRUE "Ubuntu" \
  FALSE "Fedora" \
  FALSE "Arch" \
  --width 400 --height 300)
 
echo "选中：$os"

示例 2：多选列表（选择要安装的工具）

tools=$(zenity --list --checklist \
  --title "工具选择" \
  --text "选择要安装的开发工具：" \
  --column "选择" --column "工具" \
  FALSE "Git" \
  TRUE "VS Code" \
  FALSE "Docker" \
  --width 400 --height 300)
 
# 处理多选结果（以 | 分隔）
echo "选中工具：$tools"  # 输出：选中工具：Git|VS Code

2.5 进度对话框（Progress Dialog）#

用于展示长时间任务的进度（如文件复制、编译），通过 --progress 启用。

常用选项：

--percentage N：初始进度百分比
--auto-close：进度 100% 时自动关闭
--auto-kill：用户取消时终止关联进程
--text "描述"：进度文本说明

示例：模拟任务进度

(
  echo "0" ; sleep 1  # 0%，延迟 1 秒
  echo "# 正在准备..." ; sleep 1
  echo "30" ; sleep 1  # 30%
  echo "# 任务进行中..." ; sleep 1
  echo "70" ; sleep 1  # 70%
  echo "# 即将完成..." ; sleep 1
  echo "100"           # 100%
) | zenity --progress \
  --title "进度演示" \
  --text "初始化..." \
  --percentage 0 \
  --auto-close \
  --width 400

2.6 日历对话框（Calendar Dialog）#

用于选择日期，通过 --calendar 启用。

常用选项：

--date-format "格式"：自定义输出日期格式（如 %Y-%m-%d）

示例：选择日期并格式化输出

date=$(zenity --calendar \
  --title "选择日期" \
  --text "请选择一个日期：" \
  --date-format "%Y-%m-%d" \  # 输出格式：年-月-日
  --width 300)
 
echo "选中日期：$date"  # 输出：选中日期：2024-05-20

2.7 颜色选择对话框（Color Selection Dialog）#

用于选择颜色，通过 --color-selection 启用。

常用选项：

--color "#RRGGBB"：预设颜色（十六进制）
--show-palette：显示调色板

示例：选择颜色并输出十六进制代码

color=$(zenity --color-selection \
  --title "选择颜色" \
  --color "#FF5733" \  # 默认橙色
  --show-palette \
  --width 300)
 
echo "选中颜色：$color"  # 输出：选中颜色：#ff5733

3. 高级特性#

3.1 多字段表单（--forms）#

通过 --forms 创建包含多个输入字段的表单，适合收集结构化数据（如姓名、邮箱、电话）。

选项：

--add-entry "字段名"：添加文本输入框
--add-password "字段名"：添加密码框
--add-calendar "字段名"：添加日期选择器
--forms-date-format "格式"：日期字段输出格式

示例：用户注册表单

form_output=$(zenity --forms \
  --title "用户注册" \
  --text "请填写以下信息" \
  --width 400 \
  --add-entry "姓名" \
  --add-entry "邮箱" \
  --add-password "密码" \
  --add-calendar "生日" \
  --forms-date-format "%Y-%m-%d")
 
# 解析结果（字段间以 | 分隔）
name=$(echo "$form_output" | cut -d'|' -f1)
email=$(echo "$form_output" | cut -d'|' -f2)
password=$(echo "$form_output" | cut -d'|' -f3)
birthday=$(echo "$form_output" | cut -d'|' -f4)
 
echo "姓名：$name，邮箱：$email，生日：$birthday"

3.2 系统托盘通知（--notification）#

通过 --notification 在系统托盘显示通知（无需窗口焦点）。

示例：备份完成通知

zenity --notification \
  --window-icon "info" \  # 图标：info/warning/error
  --text "📦 备份已完成！" \
  --timeout 5  # 5 秒后自动消失

3.3 自定义尺寸与文本处理#

--width N/--height N：调整对话框尺寸（避免文本溢出）
--ellipsize：长文本自动省略（末尾加 ...）
--no-wrap：禁止文本自动换行

4. 常见实践场景#

Zenity 适用于以下场景：

交互式脚本：替代 read 命令，提升用户体验
系统管理工具：如备份、日志查看、软件安装
媒体处理：选择图片/视频文件，设置处理参数
自动化工作流：任务进度展示、错误提示

5. 最佳实践#

处理用户取消行为
Zenity 对话框取消时返回 exit code 1，需在脚本中处理（如终止流程或提示用户）：
```
if [ $? -eq 1 ]; then
  echo "用户已取消"
  exit 1
fi
```
平衡 GUI 与 CLI
避免过度使用对话框：简单确认可用 --question，复杂逻辑仍建议 CLI。
适配不同桌面环境
测试对话框在 KDE、XFCE 等环境中的显示效果（尺寸、字体可能差异）。
控制对话框尺寸
通过 --width/--height 限制大小，避免在小屏幕上显示异常。
本地化支持
若脚本面向多语言用户，可通过变量动态切换 --text 内容（如中文/英文）。

6. 实战脚本示例#

6.1 系统信息收集工具#

功能：通过表单收集用户信息，结合 --list 选择要展示的系统信息（CPU/内存/磁盘），用 --progress 显示收集进度。

#!/bin/bash
 
# 步骤 1：用户信息表单
user_info=$(zenity --forms \
  --title "系统信息收集" \
  --text "请输入基本信息" \
  --width 400 \
  --add-entry "姓名" \
  --add-entry "部门")
 
[ $? -eq 1 ] && zenity --error --text "已取消" && exit 1
 
name=$(echo "$user_info" | cut -d'|' -f1)
dept=$(echo "$user_info" | cut -d'|' -f2)
 
# 步骤 2：选择要收集的信息
info_types=$(zenity --list --checklist \
  --title "选择信息类型" \
  --text "请选择要展示的系统信息：" \
  --column "选择" --column "类型" \
  TRUE "CPU 信息" \
  TRUE "内存使用" \
  FALSE "磁盘空间" \
  --width 400)
 
[ $? -eq 1 ] && zenity --error --text "已取消" && exit 1
 
# 步骤 3：进度展示
(
  echo "0" ; echo "# 初始化..." ; sleep 1
  echo "30" ; echo "# 收集 CPU 信息..." ; sleep 1
  echo "60" ; echo "# 收集内存信息..." ; sleep 1
  echo "100" ; echo "# 完成！" ; sleep 1
) | zenity --progress --title "收集进度" --auto-close --width 400
 
# 步骤 4：展示结果
result="用户：$name（$dept）\n\n"
[ $(echo "$info_types" | grep "CPU") ] && result+="CPU 核心数：$(nproc)\n"
[ $(echo "$info_types" | grep "内存") ] && result+="内存使用：$(free -h | awk '/Mem/{print $3}')\n"
 
zenity --info --title "系统信息结果" --text "$result" --width 400

6.2 照片整理助手#

功能：选择照片目录、目标目录，设置分类标签（通过 --list），批量复制文件并显示进度。

#!/bin/bash
 
# 选择源目录
src_dir=$(zenity --file-selection --directory --title "选择照片源目录")
[ $? -eq 1 ] && exit 1
 
# 选择目标目录
dest_dir=$(zenity --file-selection --directory --title "选择目标目录")
[ $? -eq 1 ] && exit 1
 
# 选择分类标签
tag=$(zenity --list --radiolist \
  --title "选择分类标签" \
  --column "选择" --column "标签" \
  TRUE "风景" \
  FALSE "人像" \
  FALSE "美食" \
  --width 300)
[ $? -eq 1 ] && exit 1
 
# 创建目标子目录
target="$dest_dir/$tag"
mkdir -p "$target"
 
# 获取照片文件列表（仅 .jpg/.png）
photos=$(find "$src_dir" -maxdepth 1 -type f \( -name "*.jpg" -o -name "*.png" \) | wc -l)
[ $photos -eq 0 ] && zenity --error --text "未找到照片文件" && exit 1
 
# 复制文件并显示进度
find "$src_dir" -maxdepth 1 -type f \( -name "*.jpg" -o -name "*.png" \) | \
  while read -r file; do
    cp -v "$file" "$target"
    echo $(( (++count * 100) / photos ))  # 计算进度百分比
  done | zenity --progress \
    --title "复制中" \
    --text "正在整理照片到 $tag 分类..." \
    --auto-close \
    --width 400
 
zenity --info --text "✅ 成功整理 $count 张照片到 $target" --width 300

7. 故障排除#

问题 1：对话框无法显示#

原因：未设置 DISPLAY 环境变量（如 SSH 无 X 转发）。
解决：确保在图形界面终端运行，或通过 export DISPLAY=:0 指定显示设备。

问题 2：中文显示乱码#

原因：系统 locale 未配置中文。
解决：设置 LANG=zh_CN.UTF-8（在脚本开头添加 export LANG=zh_CN.UTF-8）。

问题 3：进度对话框无响应#

原因：未通过管道持续输出进度数据。
解决：确保进度更新逻辑正确（如循环中 echo $percentage）。

问题 4：exit code 异常#

原因：未区分取消（1）、超时（5）、错误（-1）等 exit code。
解决：通过 $? 捕获并处理不同返回值。

8. 总结#

Zenity 是一款轻量但强大的工具，它填补了 shell 脚本与图形界面之间的鸿沟，让开发者无需掌握复杂 GUI 框架即可创建交互式应用。通过本文介绍的对话框类型、高级特性和最佳实践，你可以快速提升脚本的易用性和专业性。无论是系统管理、自动化工具还是日常脚本，Zenity 都能成为你的得力助手。

目录#

1. 安装 Zenity#

2. 基本用法与核心对话框类型#

2.1 消息对话框（Message Dialog）#

2.2 输入对话框（Entry Dialog）#

2.3 文件选择对话框（File Selection Dialog）#

2.4 列表对话框（List Dialog）#

2.5 进度对话框（Progress Dialog）#

2.6 日历对话框（Calendar Dialog）#

2.7 颜色选择对话框（Color Selection Dialog）#

3. 高级特性#

3.1 多字段表单（--forms）#

3.2 系统托盘通知（--notification）#

3.3 自定义尺寸与文本处理#

4. 常见实践场景#

5. 最佳实践#

6. 实战脚本示例#

6.1 系统信息收集工具#

6.2 照片整理助手#

7. 故障排除#

问题 1：对话框无法显示#

问题 2：中文显示乱码#

问题 3：进度对话框无响应#

问题 4：exit code 异常#

8. 总结#

9. 参考资料#