a=42
b=10

# 算术上下文：自动转换为数字
echo "$((a + b))"   # 输出: 52

# 字符串上下文：保持字符串
echo "值是: $a"      # 输出: 值是: 42

# declare 可以声明类型（但本质上仍是字符串）
declare -i num=10
num=num+5
echo "$num"          # 输出: 15
num="hello"
echo "$num"          # 输出: 0（无法转换为整数时变成 0）

declare -l lower="Hello World"
echo "$lower"        # 输出: hello world

declare -u upper="hello world"
echo "$upper"        # 输出: HELLO WORLD

# nameref：间接引用（类似指针）
greet() {
    local -n ref=$1   # $1 是变量名
    ref="Hello, ${ref}!"
}
name="World"
greet name
echo "$name"          # 输出: Hello, World!

#!/bin/bash

# 全局变量（脚本级别）
global_var="我是全局变量"

my_function() {
    # 局部变量：仅在函数内可见
    local local_var="我是局部变量"
    
    # 全局变量在函数内也可以访问
    echo "函数内: $global_var"
    echo "函数内: $local_var"
}

my_function
echo "函数外: $global_var"
# echo "$local_var"  # ❌ 未定义，为空

# local 的注意事项
test_scope() {
    # local 只在函数中有效
    # 如果在函数外使用 local，Bash 会报错
    # local x=10  # 如果在函数外
    
    # 递归中的 local
    local count=${1:-0}
    echo "$count"
    [[ $count -lt 3 ]] && test_scope $((count + 1))
    # 递归中每次调用都有自己独立的 local count
}
test_scope

#!/bin/bash

# ⚠️ 陷阱一：忘记 local 声明污染全局
bad_function() {
    counter=0           # 这是全局变量！
    counter=$((counter + 1))
}

good_function() {
    local counter=0     # ✅ 正确：局部变量
    counter=$((counter + 1))
}

# ⚠️ 陷阱二：管道中的变量在子 Shell 中
# 管道的每一段都在子 Shell 中执行
echo "hello" | read greeting
echo "$greeting"        # ❌ 为空！

# ✅ 正确方法：进程替换
read greeting < <(echo "hello")
echo "$greeting"        # 输出: hello

# ✅ 正确方法：lastpipe（Bash 4.2+）
shopt -s lastpipe
echo "hello" | read greeting
echo "$greeting"        # 输出: hello

# 查看所有环境变量
env
printenv

# 查看特定变量
echo "$PATH"
echo "$HOME"

# 导出为环境变量
export MY_VAR="hello"

# 或者先定义再导出
MY_VAR="hello"
export MY_VAR

# 环境变量只影响当前进程及子进程
# 不影响父进程和兄弟进程

# 查看 PATH
echo "$PATH" | tr ':' '\n'

# 追加到 PATH（不重启永久生效需写入配置文件）
export PATH="$PATH:/opt/myapp/bin"

# 前置到 PATH（优先搜索）
export PATH="/opt/myapp/bin:$PATH"

# 检查命令是否在 PATH 中
command -v bash        # 输出: /bin/bash
which bash             # 输出: /bin/bash
type bash              # 输出: bash is /bin/bash

# 检查命令是否存在
if command -v docker &>/dev/null; then
    echo "Docker 已安装"
else
    echo "Docker 未安装"
fi

#!/bin/bash
# special_vars.sh —— 展示特殊变量

echo "脚本名称:    $0"
echo "参数个数:    $#"
echo "所有参数:    $*"
echo "所有参数:    $@"
echo "第一个参数:  $1"
echo "第二个参数:  $2"
echo "上一个PID:   $$"
echo "上一个退出码: $?"
echo "Shell 选项:  $-"

#!/bin/bash

echo '--- $* ---'
for arg in $*; do
    echo "  arg: '$arg'"
done

echo '--- "$*" ---'
for arg in "$*"; do
    echo "  arg: '$arg'"
done

echo '--- $@ ---'
for arg in $@; do
    echo "  arg: '$arg'"
done

echo '--- "$@" (推荐) ---'
for arg in "$@"; do
    echo "  arg: '$arg'"
done

# 调用: ./script.sh "hello world" "foo bar"
# "$*" 输出两个参数合并为一个: "hello world foo bar"
# "$@" 保持原始参数分隔: "hello world" 和 "foo bar"（推荐）

# 声明方式一：直接赋值
fruits=("apple" "banana" "cherry" "date")

# 声明方式二：逐个赋值
colors[0]="red"
colors[1]="green"
colors[2]="blue"

# 声明方式三：declare
declare -a numbers=(10 20 30 40 50)

# 读取元素
echo "${fruits[0]}"     # 输出: apple（索引从 0 开始）
echo "${fruits[2]}"     # 输出: cherry

# 读取所有元素
echo "${fruits[@]}"     # 输出: apple banana cherry date
echo "${fruits[*]}"     # 输出: apple banana cherry date

# 数组长度
echo "${#fruits[@]}"    # 输出: 4

# 添加元素
fruits+=("elderberry")

# 切片
echo "${fruits[@]:1:2}" # 输出: banana cherry（从索引1开始取2个）

# 必须先声明为关联数组
declare -A user

# 赋值
user[name]="张三"
user[age]=30
user[role]="工程师"
user[email]="[email protected]"

# 读取
echo "${user[name]}"    # 输出: 张三
echo "${user[role]}"    # 输出: 工程师

# 所有键
echo "${!user[@]}"      # 输出: name age role email

# 所有值
echo "${user[@]}"       # 输出: 张三 30 工程师 [email protected]

# 长度
echo "${#user[@]}"      # 输出: 4

# 遍历
for key in "${!user[@]}"; do
    echo "$key = ${user[$key]}"
done

# 判断键是否存在
if [[ -v user[name] ]]; then
    echo "name 存在"
fi

#!/bin/bash
# check_env.sh —— 检查部署环境
set -euo pipefail

declare -A required_tools=(
    [git]="版本控制"
    [docker]="容器运行时"
    [curl]="HTTP 客户端"
    [jq]="JSON 处理"
)

declare -A optional_tools=(
    [terraform]="基础设施管理"
    [ansible]="配置管理"
    [helm]="K8s 包管理"
)

check_tool() {
    local tool=$1
    local desc=$2
    local required=$3

    if command -v "$tool" &>/dev/null; then
        local version
        version=$("$tool" --version 2>/dev/null | head -1 || echo "未知版本")
        printf "  ✅ %-15s %s\n" "$tool" "$version"
        return 0
    else
        if [[ "$required" == "yes" ]]; then
            printf "  ❌ %-15s %s (必需！)\n" "$tool" "$desc"
            return 1
        else
            printf "  ⚠️  %-15s %s (可选)\n" "$tool" "$desc"
            return 0
        fi
    fi
}

echo "================================"
echo "  环境依赖检查"
echo "================================"

echo ""
echo "[必需工具]"
errors=0
for tool in "${!required_tools[@]}"; do
    check_tool "$tool" "${required_tools[$tool]}" "yes" || ((errors++))
done

echo ""
echo "[可选工具]"
for tool in "${!optional_tools[@]}"; do
    check_tool "$tool" "${optional_tools[$tool]}" "no"
done

echo ""
if [[ $errors -gt 0 ]]; then
    echo "❌ 发现 $errors 个必需工具缺失，请先安装。"
    exit 1
else
    echo "✅ 环境检查通过！"
fi