命令行与文本处理 / 系统课时

怎样读取脚本的位置参数

怎样读取脚本的位置参数

Shell 脚本可以直接读取调用命令后传入的参数,从而让同一个脚本处理不同文件、目录或服务。位置参数按顺序保存为 $1、$2、$3 等,脚本通常还需要检查参数数量和空值,避免缺少输入时继续执行错误操作。

学习目标

  • 使用 $1、$2、$3 读取调用脚本时传入的位置参数
  • 使用 $# 判断参数数量,并为缺少参数的调用返回明确错误
  • 理解 "$@" 在需要继续传递全部参数时的作用

参数按调用顺序进入脚本

执行 bash task.sh alpha beta 时,$1 的值是 alpha,$2 的值是 beta。$0 保存脚本自身的名称,而 $# 表示实际收到的位置参数数量。

下面编写一个脚本,让调用者动态指定文件、备份目录和服务名称:

bash
#!/usr/bin/env bash
set -u

file="${1:-}"
backup_dir="${2:-}"
service="${3:-}"

if [[ -z "$file" || -z "$backup_dir" || -z "$service" ]]; then
  printf 'Usage: %s <file> <backup-dir> <service>\n' "$0" >&2
  exit 2
fi

printf 'file=%s\n' "$file"
printf 'backup_dir=%s\n' "$backup_dir"
printf 'service=%s\n' "$service"
printf 'argument_count=%s\n' "$#"

将脚本保存为 inspect-args.sh 后执行:

bash
bash inspect-args.sh /var/log/app.log /srv/backup nginx

预期输出:

text
file=/var/log/app.log
backup_dir=/srv/backup
service=nginx
argument_count=3

这里使用 ${1:-} 而不是直接读取 $1,是因为脚本启用了 set -u。如果调用者没有提供第一个参数,直接展开未设置的 $1 会立即报错;${1:-} 会先得到空字符串,让脚本能够进入自己的参数检查逻辑。

缺少参数时先停止执行

自动化脚本不应在参数不足时继续执行。例如备份目录缺失后仍运行复制命令,可能导致文件被写入错误位置。因此应在真正操作文件、服务或数据库之前完成参数校验。

只传入两个参数时:

bash
bash inspect-args.sh /var/log/app.log /srv/backup

预期结果为退出状态码 2,并在标准错误输出中显示类似下面的用法提示;脚本路径会随实际调用方式变化:

text
Usage: <PATH> <file> <backup-dir> <service>

调用者可以通过退出状态码判断脚本是否因为输入错误而终止,这比让后续命令在缺少参数的状态下随机失败更容易排查。

需要全部参数时使用 "$@"

除了单独读取 $1、$2,Shell 还提供 "$@" 表示全部位置参数,并且会保留每个参数原本的边界。它常用于包装其他命令或把当前脚本收到的参数继续传给另一个程序。

下面的脚本逐个打印所有参数:

bash
#!/usr/bin/env bash

for arg in "$@"; do
  printf '<%s>\n' "$arg"
done

执行:

bash
bash show-args.sh "daily report.log" /srv/backup nginx

预期输出:

text
<daily report.log>
</srv/backup>
<nginx>

第一个参数虽然包含空格,但因为循环使用的是 "$@",它仍然保持为一个完整参数。编写处理文件名和用户输入的脚本时,不应省略这里的双引号。

位置参数适合简单而固定的接口

当脚本只需要少量且顺序固定的输入时,位置参数最直接,例如 backup.sh <source> <target>。如果参数越来越多,调用者开始难以记住第三个、第四个参数分别代表什么,就更适合进一步设计带选项名称的参数解析,而不是无限增加位置参数。

读取位置参数时,核心顺序是先取得输入,再检查数量和内容,最后才执行真实操作。这样脚本既能复用于不同对象,也能在错误调用发生时尽早停止。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

怎样读取脚本的位置参数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通