Shell 脚本最佳实践

借鉴 dylanaraps/pure-bash-bible (42k⭐) + Google Shell Style Guide。

脚本模板

#!/usr/bin/env bash
set -euo pipefail  # 严格模式：出错即停、未定义变量报错、管道错误

# 颜色
RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; NC='\033[0m'

# 用法
usage() {
    echo "用法: $0 [选项] <参数>"
    echo "  -h  帮助"
    echo "  -v  详细输出"
    exit 1
}

# 参数解析
VERBOSE=false
while getopts "hv" opt; do
    case $opt in
        h) usage ;;
        v) VERBOSE=true ;;
        *) usage ;;
    esac
done
shift $((OPTIND-1))

# 主逻辑
main() {
    log "开始执行..."
    # ...
}

# 日志
log() { echo -e "${GREEN}[INFO]${NC} $(date '+%H:%M:%S') $*"; }
warn() { echo -e "${YELLOW}[WARN]${NC} $*" >&2; }
err() { echo -e "${RED}[ERROR]${NC} $*" >&2; exit 1; }

main "$@"

纯 Bash 技巧（省掉外部命令）

# 字符串操作
s="hello world"
echo "${s^}"       # Hello world（首字母大写）
echo "${s^^}"      # HELLO WORLD（全大写）
echo "${s,}"       # hello world（首字母小写）
echo "${s,,}"      # hello world（全小写）
echo "${s/world/郑鑫}"  # hello 郑鑫（替换）

# 默认值
echo "${VAR:-默认值}"       # VAR为空时用默认值
echo "${VAR:=默认值}"       # VAR为空时赋值默认值
: "${VAR:?必须设置}"        # VAR为空时报错退出

# 数组
arr=(a b c)
echo "${arr[0]}"          # a
echo "${arr[@]}"          # a b c（所有元素）
echo "${#arr[@]}"         # 3（长度）
arr+=(d)                  # 追加

# 循环
for i in {1..10}; do echo "$i"; done
for f in *.txt; do echo "$f"; done

# 条件
[[ -f "$file" ]]   # 文件存在且是普通文件
[[ -d "$dir" ]]    # 目录存在
[[ -z "$str" ]]    # 字符串为空
[[ -n "$str" ]]    # 字符串非空
[[ "$a" == "$b" ]] # 字符串相等

# 数学运算
((count++))
((total += value))
echo $((10 + 5 * 3))  # 25

# 子串
echo "${s:0:5}"    # hello（位置0起取5个字符）
echo "${s#*.}"     # txt（去掉最短匹配前缀）
echo "${s##*.}"    # txt（去掉最长匹配前缀）
echo "${s%.*}"     # file（去掉最短匹配后缀）
echo "${s%%.*}"    # file（去掉最长匹配后缀）

严格模式详解

set -e  # 任何命令返回非0就退出
set -u  # 使用未定义变量就退出
set -o pipefail  # 管道中任何一个命令失败都算失败

# 如果你需要某个命令失败不退出：
command_that_may_fail || true

# 如果需要检查返回值：
if ! command; then
    echo "失败了"
fi

常见模式

# 确保在项目根目录
cd "$(dirname "$0")/.."

# 临时目录 + 自动清理
tmp=$(mktemp -d)
trap 'rm -rf "$tmp"' EXIT

# 检查依赖
for cmd in git curl jq; do
    if ! command -v "$cmd" >/dev/null; then
        err "需要 $cmd，请先安装"
    fi
done

# 确认操作
read -p "确认? (y/n) " -n 1 -r; echo
[[ $REPLY =~ ^[Yy]$ ]] || exit 0

# 逐行读文件
while IFS= read -r line; do
    echo "$line"
done < file.txt