ZeroTermux 命令速查中的 bash read 命令:从键盘读取变量值到交互式脚本实战

原创2026-10-13 14:32:542,322 阅读
文章标签:移动开发开发工具CLI

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 用法可作为真实工程参考。
登录后查看全文
ZeroTermux