ZeroTermux 命令速查中的 bash read 命令:从键盘读取变量值到交互式脚本实战
ZeroTermux 命令速查中的 bash read 命令:从键盘读取变量值到交互式脚本实战
在 Shell 脚本中,read 是构建命令行交互界面的核心命令:它从标准输入读取一行文本,按规则拆分后赋值给变量或数组,并支持提示符、超时、定界符等控制。ZeroTermux 将 read 的完整用法内置为 App 内的命令速查文档(app/src/main/assets/cmd/read.md),读者读完本篇后,既能掌握 read 的全部选项与典型示例,也能看到该文档在 ZeroTermux 中被 WebView 渲染展示的源码链路,以及仓库脚本中 read -r -p 的真实工程化用法。
一、ZeroTermux 中的 read 命令文档与渲染链路
ZeroTermux 在 assets/cmd/ 目录下内置了一整套 Linux 命令速查文档(cat、echo、grep 等均为一个 .md 文件),read 命令对应的就是 app/src/main/assets/cmd/read.md。
从源码结构看,该文档由命令面板对话框加载并渲染:
- CommandDialog.java 通过
AssetManager.list("cmd")列出cmd目录下的所有文档名,填充可搜索列表; - 点击某个命令后,showCmdDetail 打开
cmd/<命令名>资源文件,用 commonmark 的Parser将 Markdown 解析为Node树,再经HtmlRenderer渲染成 HTML,最后loadData到 WebView 展示; - 面板入口在 BoomWindow.java:点击底部工具条的“命令”按钮后弹出
CommandDialog。
也就是说,你在 ZeroTermux 中看到的 read 命令帮助页,本质就是本文所讲的这份 Markdown 文档在 App 内的实时渲染结果。
二、read 命令基础:语法、选项与参数
read 命令 从键盘读取变量的值,通常用在 shell 脚本中与用户进行交互的场合。该命令可以一次读取多个变量的值,变量和输入的值都需要使用空格隔开。在 read 命令后面,如果没有指定变量名,读取的数据将被自动赋值给特定的变量 REPLY。
语法
read(选项)(参数)
选项
原文明档在“选项”一节中列出了两个核心选项:
| 选项 | 说明 |
|---|---|
-p |
指定读取值时的提示符; |
-t |
指定读取值时等待的时间(秒)。 |
结合文档“实例”一节中出现的其他用法,实际使用中还会配合以下选项(均为原文档示例中直接给出的用法):
| 选项 | 说明 | 示例 |
|---|---|---|
-a |
把单词清单读入指定数组 | read -a arrayname |
-r |
允许输入包含反斜杠(禁用反斜杠转义) | read -r line |
-n |
只读取指定字符数,不需要按回车 | read -n 2 var |
-d |
使用自定义定界符结束输入行 | read -d ":" var |
-s |
静默模式,回显屏蔽(常用于密码输入) | read -p "输入密码:" -s pwd |
参数
变量:指定读取值的变量名。
三、常用方式速览
下面是原文档给出的 read 命令常用方式,逐条对应其行为:
read 1987name
从标准输入读取输入并赋值给变量1987name。
read first last
从标准输入读取输入到第一个空格或者回车,将输入的第一个单词放到变量first中,并将该行其他的输入放在变量last中。
read
从标准输入读取一行并赋值给特定变量REPLY。
read -a arrayname
把单词清单读入arrayname的数组里。
read -p "text"
打印提示(text),等待输入,并将输入存储在REPLY中。
read -r line
允许输入包含反斜杠。
read -t 3
指定读取等待时间为3秒。
read -n 2 var
从输入中读取两个字符并存入变量var,不需要按回车读取。
read -d ":" var
用定界符“:”结束输入行。
四、read 命令示例详解
1. 基础赋值:读取输入给单个变量
从标准输入读取输入并赋值给变量 1987name:
#read 1987name #等待读取输入,直到回车后表示输入完毕,并将输入赋值给变量answer
HelloWorld #控制台输入HelloWorld
#echo $1987name #打印变量
HelloWorld
2. 一次读取多个变量
等待一组输入,每个单词之间使用空格隔开,直到回车结束,并分别将单词依次赋值给读入变量:
#read one two three
1 2 3 #在控制台输入1 2 3,它们之间用空格隔开。
#echo "one = $one, two = $two, three = $three"
one = 1, two = 2, three = 3
3. 使用内置变量 REPLY
#read #等待控制台输入,并将结果赋值给特定内置变量REPLY。
This is REPLY #在控制台输入该行。
#echo $REPLY #打印输出特定内置变量REPLY,以确认是否被正确赋值。
This is REPLY
4. -p 选项:显示提示符
#read -p "Enter your name: " #输出文本提示,同时等待输入,并将结果赋值给REPLY。
Enter your name: stephen #在提示文本之后输入stephen
#echo $REPLY
stephen
5. -a 选项:读入数组
等待控制台输入,并将输入信息视为数组,赋值给数组变量 friends,输入信息用空格隔开数组的每个元素:
#read -a friends
Tim Tom Helen
#echo "They are ${friends[0]}, ${friends[1]} and ${friends[2]}."
They are Tim, Tom and Helen.
6. 终端输入密码时不显示回显(两种方法)
方法 1:使用 -s 静默选项
#!/bin/bash
read -p "输入密码:" -s pwd
echo
echo password read, is "$pwd"
方法 2:使用 stty 切换终端回显
#!/bin/bash
stty -echo
read -p "输入密码:" pwd
stty echo
echo
echo 输入完毕。
其中,选项 -echo 禁止将输出发送到终端,而选项 echo 则允许发送输出。
7. 双变量读取与输出注意事项
使用 read 命令从键盘读取变量值,并且将值赋给指定的变量:
read v1 v3 #读取变量值
执行上面的指令以后,要求键入两个数据,如下所示:
Linux c+ #输入数据
完成之后,可以使用 echo 命令将指定的变量值输出查看:
echo $v1 $3 #输出变量的值
执行输出变量值的命令以后,将显示用户所输入的数据值:
Linux c+ #输出变量值
注意:使用 echo 命令输出变量值时,必须在变量名前添加符号 $。否则,echo 将直接输出变量名。
五、仓库源码印证:ZeroTermux 脚本中的 read 工程化用法
上面的 -p、-r、多变量与 case 选择菜单模式,在 ZeroTermux 自带的启动脚本中得到了直接印证。
app/src/main/assets/linux/termux_toolx.sh 中的 CONFIRM() 函数封装了“暂停等待用户”的标准写法:
CONFIRM() {
read -r -p "按回车键继续" input
case $input in
*) ;; esac
}
这里 read -r -p 的组合正是前文两个选项的联合使用:-p 输出“按回车键继续”提示,-r 保证用户输入中的反斜杠按字面处理。同文件 SYS_SELECT() 则展示了典型的菜单交互流程——先 echo -e 打印编号选项,再 read -r -p "请选择:" input 读取选择,随后用 case $input in 1) ... 2) ... 分支处理,这正是原文档“read first last 按空格拆词赋值”特性在菜单脚本中的典型应用形态。
在 app/src/main/assets/qemu/utqemu.sh 这一较长的引导脚本中,同样的模式被大量复用,例如 read -r -p "1)curl 2)wget :" input、read -r -p "1)继续 9)返回 0)退出 " input 等(见文件第 117、681 行附近),覆盖了“选择下载工具”“格式化转换”“版本更新确认”等多个交互节点,验证了原文档中 read 在 shell 脚本交互场合的定位。
六、小结
read不带变量时赋值给内置变量REPLY,带变量时按空格把一行输入依次拆分给各变量;-p提供提示符、-t提供超时秒数,二者是原文档明确列出的核心选项;-a、-r、-n、-d、-s等扩展选项则在原文档示例中给出了具体行为;- 密码输入推荐
read -s或stty -echo两种方案; - ZeroTermux 中该文档由 CommandDialog.java 的 commonmark 解析链路渲染展示,仓库脚本 termux_toolx.sh 与 utqemu.sh 中的
read -r -p用法可作为真实工程参考。