Linux 与服务器运维 / 系统课时

用参数展开处理默认值

用参数展开处理默认值

Shell 脚本读取环境变量和命令参数时,经常需要处理未设置、空值、必填项以及路径裁剪。Bash 参数展开可以在不额外启动 sed、awk 等进程的情况下完成这些判断,让配置读取更紧凑也更可靠。

学习目标

  • 区分未设置变量与空字符串,并选择合适的默认值语法
  • 使用参数展开完成必填参数校验
  • 使用前缀、后缀删除完成常见字符串裁剪

为可选配置提供默认值

最常见的形式是 ${var:-default}。当变量没有设置,或者变量值为空字符串时,它都会返回默认值,但不会修改变量本身。

下面的脚本读取部署环境和端口,并允许调用方通过环境变量覆盖默认配置:

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

env_name="${APP_ENV:-production}"
port="${APP_PORT:-8080}"

echo "environment: $env_name"
echo "port: $port"

直接运行时,预期输出:

text
environment: production
port: 8080

如果执行 APP_ENV=staging APP_PORT=9090 ./script.sh,则预期输出为:

text
environment: staging
port: 9090

${var-default} 与 ${var:-default} 的区别在于是否把空字符串视为“缺失”。前者只在变量完全未设置时采用默认值;后者在变量未设置或为空时都会采用默认值。配置项通常不允许空值,因此运维脚本中更常见的是 :-。

默认值是否写回变量

${var:=default} 不只是返回默认值,还会在变量未设置或为空时把默认值赋回变量。只有后续逻辑确实需要变量已经被初始化时,才需要这种形式。

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

unset LOG_DIR

echo "resolved: ${LOG_DIR:=/var/log/myapp}"
echo "stored: $LOG_DIR"

预期输出:

text
resolved: /var/log/myapp
stored: /var/log/myapp

相比之下,${LOG_DIR:-/var/log/myapp} 只产生一个展开结果,不会改变 LOG_DIR。如果只是读取配置,优先使用 :-,可以减少变量在脚本中被隐式修改的情况。

对必填参数立即失败

部署目标、密钥文件路径或目标集群等关键配置不应该默默使用错误默认值。${var:?message} 可以在变量未设置或为空时直接终止当前非交互 Shell,并打印错误信息。

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

TARGET_HOST="${TARGET_HOST:?TARGET_HOST is required}"
echo "deploy to: $TARGET_HOST"

设置变量后执行,例如 TARGET_HOST=web-01 ./script.sh,预期输出:

text
deploy to: web-01

未设置 TARGET_HOST 时,脚本会以非零状态结束,并显示包含 TARGET_HOST is required 的错误信息。错误信息前通常还会带脚本名和行号,不同 Bash 版本的完整格式可能略有差异,因此自动化测试应关注退出状态和关键文本,而不是固定整行错误内容。

用参数展开裁剪字符串

Bash 还可以直接删除字符串开头或结尾匹配的模式。${var#pattern} 删除最短前缀,${var##pattern} 删除最长前缀;${var%pattern} 和 ${var%%pattern} 则处理后缀。

下面从文件路径中分别取出文件名和目录:

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

file_path="/opt/apps/demo/config.yaml"
file_name="${file_path##*/}"
dir_name="${file_path%/*}"

echo "file: $file_name"
echo "dir: $dir_name"

预期输出:

text
file: config.yaml
dir: /opt/apps/demo

这里的模式遵循 Shell 通配规则,而不是正则表达式。##*/ 表示删除直到最后一个 / 为止的最长前缀,%/* 则删除最后一个 / 以及其后的最短后缀。

选择合适的展开形式

读取可选配置时使用 ${var:-default};需要把默认值真正写回变量时使用 ${var:=default};关键配置缺失必须立即失败时使用 ${var:?message};对路径、文件名等简单字符串做前后裁剪时使用 #、##、% 或 %%。把这些规则放在变量读取入口处,可以让后续业务逻辑少写很多重复的条件判断。

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

目录与阅读设置

阅读设置

17

记录一个想法

用参数展开处理默认值

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

登录哪都通