变量、流程控制与函数

# 赋值：等号两侧不能有空格
name="plume"             # ✅ 正确
# name = "plume"         # ❌ 会被解析成执行命令 name 加参数

# 读取：前面加 $，推荐用花括号隔离边界
echo "$name"
echo "欢迎 ${name} 用户"   # 花括号防止 name 与 "用户" 粘连成新变量名

# 环境变量：export 后子进程可见
export PATH="$PATH:/opt/mybin"

dirs="one two three"
# 无引号：拆成 3 个参数
for d in $dirs; do echo "dir=$d"; done

# 加引号：当成 1 个整体
for d in "$dirs"; do echo "whole=$d"; done

msg="hello world"
printf '<%s>\n' $msg      # <hello> <world>  词分裂
printf '<%s>\n' "$msg"    # <hello world>    整体
printf '%s\n' '$msg'      # $msg             字面量

# 参数数组也一样：$@ 与 "$@" 是天壤之别
set -- "a b" "c d"
printf '<%s>\n' $@        # <a> <b> <c> <d>   分裂
printf '<%s>\n' "$@"      # <a b> <c d>       保留

# :- 有值用值，无值用默认（变量保持原状）
echo "${USER:-guest}"
# := 无值时顺带把默认值写回变量
echo "${port:=8080}"
# :? 无值时报错退出（调试利器）
echo "${required_var:?必须设置}"
# :+ 有值才替换，无值留空
echo "${DEBUG:+已开启调试}"

file="archive.tar.gz"
echo "${file%.*}"      # archive.tar   去最短后缀
echo "${file%%.*}"     # archive       去最长后缀
echo "${file##*.}"     # gz            取扩展名

# 大小写转换（Bash 4+）
echo "${name^^}"       # 全大写
echo "${name,,}"       # 全小写

if grep -q "error" /var/log/app.log; then
  echo "日志中存在 error"
fi

# 常见写法：if test 条件
if [ "$count" -gt 5 ]; then
  echo "count 大于 5"
elif [ "$count" -eq 5 ]; then
  echo "正好 5"
else
  echo "小于 5"
fi

# 推荐使用 [[ ]]，支持模式匹配与正则
[[ "$name" == p* ]] && echo "以 p 开头"
[[ "$url" =~ ^https?:// ]] && echo "合法 URL"

# 防御性写法：变量加双引号避免 test 报错
[ -n "$var" ] && echo "非空"

# 标准 for
for env in dev test prod; do
  echo "部署到 $env"
done

# 花括号与 seq 生成序列
for i in {1..5}; do
  echo "i=$i"
done

# C 风格 for（Bash 支持）
for ((i=0; i<10; i++)); do
  printf '%d ' "$i"
done
echo

# 逐行读取文件（核心惯用法）
while IFS= read -r line; do
  printf '处理: %s\n' "$line"
done < config.txt

# until：直到条件成立才退出
until ping -c 1 db-host >/dev/null 2>&1; do
  echo "等待数据库..."
  sleep 2
done

case "$1" in
  start)
    echo "启动服务"
    ;;
  stop|shutdown)
    echo "停止服务"
    ;;
  restart)
    echo "重启服务"
    ;;
  *)
    echo "用法: $0 {start|stop|restart}"
    exit 1
    ;;
esac

# 判断扩展名
case "$file" in
  *.md)  echo "Markdown";;
  *.sh)  echo "Shell 脚本";;
  *)     echo "未知类型";;
esac

# case 里也能用变量展开与命令替换
case "$(date +%u)" in
  6|7) echo "周末";;
  *)   echo "工作日";;
esac

# 两种定义等价，推荐 function 关键字风格
log() {
  local level="$1"
  shift
  echo "[$level] $*"
}

deploy() {
  local app="$1"
  if [[ -z "$app" ]]; then
    return 1        # 返回退出码 1
  fi
  echo "部署 $app"
}

log INFO "开始构建"
deploy "web" && log OK "部署完成"

counter=0
increment() {
  local step="${1:-1}"       # local 局部
  counter=$((counter + step)) # 修改全局
}
increment 2
echo "counter=$counter"      # 2

# 函数名冲突防护：命名带前缀
# 如 mylib_connect / mylib_close，避免覆盖系统函数