shell脚本需兼顾可读性、安全性和可维护性：首行用#!/usr/bin/env bash，启用set -euo pipefail和lang=c.utf-8；变量加引号、命名规范、函数显式声明local；结构分层、错误主动捕获、配置外置、路径防御、权限可控，并用shellcheck检查。

写 Shell 脚本不是“能跑就行”，而是要让别人（包括三个月后的你自己）一眼看懂、放心修改、安全复用。规范不是束缚，是降低协作成本、减少线上事故的基础设施。

脚本开头必须明确解释器与运行环境

首行必须是 #!/usr/bin/env bash，兼容不同系统中 bash 的安装路径，避免因默认 shell 差异（如 CentOS 的 /bin/sh 是 dash）导致静默失败。紧随其后应启用严格模式和编码声明：

• set -euo pipefail：未定义变量、命令失败、管道任一环节出错均立即终止
• export LANG=C.UTF-8：统一字符编码，防止 locale 引起的字符串比较或文件名处理异常

变量与函数命名清晰且作用域分明

所有变量引用必须加双引号（"$var"），避免空格或通配符引发意外行为；赋值时等号两侧不加空格（log_dir="/var/log"）。区分变量类型：

Linux Ai Server

Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。

下载

• 全局常量用全大写 + readonly（如 readonly MAX_AGE_DAYS=30）
• 函数内变量一律用 local 显式声明（如 local file="$1"）
• 函数名以动词开头、小写+下划线（如 rotate_logs），顶部附简明注释说明用途、参数、返回值

结构分层、逻辑解耦、错误主动捕获

主流程只保留函数调用顺序，关键操作拆成独立函数。不用堆砌几十行 if-else 在 main 里。每行不超过 80 字符，管道符 | 和逻辑运算符后换行并缩进一层。条件判断统一用 [[ ]]，不混用 [ ] 或 test。

• 参数解析必须用 getopts，支持连写选项（如 -vf config.yml）、自动 help 输出
• 关键命令后加 || die "描述性错误信息"，die 函数统一输出日志并退出
• 日志分级输出：log_info、log_warn、log_error，不混用 echo

工程化落地：配置外置、路径防御、权限可控

脚本本身只负责逻辑，配置项抽到外部文件或环境变量中（如生产走 /etc/rotate.conf，开发走 ./config/dev.conf）。路径拼接前清理斜杠：full_path="${DIR%/}/${subdir#/}"；文件操作前校验存在性：[ -d "$BACKUP_DIR" ] || mkdir -p "$BACKUP_DIR"。

• 脚本命名用蛇形小写 + .sh 后缀（如 backup_mysql.sh），禁止空格、大写、特殊字符
• 权限设为 755（chmod 755 script.sh），不给 777
• 上线前必跑 shellcheck -s bash script.sh，自动发现常见陷阱