Linux运维函数封装核心是单一职责、低耦合、接口清晰：每个函数只做一件事，输入输出明确，隔离外部依赖，按领域分文件组织，并支持钩子与单元测试。
Linux运维函数封装，核心是让每个函数只干一件事、不依赖外部环境细节、调用时干净可控。
聚焦单一职责，做到高内聚
一个运维函数应围绕一个明确目标组织逻辑，比如“检查服务状态并自动重启”或“备份指定目录并压缩归档”，而不是把检查、重启、日志记录、告警全部塞进一个函数里。
- 功能内聚优先：例如
backup_mysql_db()只负责备份 MySQL 数据库，不处理 Nginx 日志轮转或磁盘清理 - 避免逻辑内聚：不要写一个
do_something()函数，靠传参-t mysql或-t nginx切换行为；应拆成backup_mysql_db()和rotate_nginx_logs() - 输入输出清晰：函数只通过参数接收必要信息（如数据库名、备份路径），只通过返回值或标准输出传递结果，不依赖全局变量或临时文件隐式传值
隔离外部依赖，实现低耦合
运维脚本常因硬编码路径、命令别名、特定工具版本或环境变量而难以复用。解耦的关键是把“变”的部分抽出来，让函数本身保持稳定。
- 封装底层命令差异：用
safe_rm()包装rm -f，内部可统一加日志或 dry-run 模式，上层函数调用时无需关心是否要加--verbose - 避免直接调用未声明的工具：函数开头用
command -v rsync &>/dev/null || { echo "rsync required"; exit 1; }显式声明依赖，而不是静默失败 - 不读取非必要环境变量：如
$HOME可以用，但$BACKUP_ROOT这类自定义变量应作为参数传入，或由配置文件加载后显式注入
用接口契约代替实现细节
函数之间应像模块一样“讲协议”，不“扒实现”。例如一个部署函数不需要知道配置文件是用 sed 替换还是用 envsubst 渲染，只要输入模板和变量即可。
- 定义简洁接口：如
deploy_app() { local app=$1 config_dir=$2; ... }，不暴露内部用了systemctl还是supervisord - 允许策略替换：用函数变量控制行为，如
LOG_LEVEL=${LOG_LEVEL:-warn}，上层可通过设置变量改变日志粒度，而不改函数体 - 错误处理标准化：统一用
return 1表示失败，配合set -e或显式判断，避免在函数里直接exit中断整个脚本流程
结构化组织与可测试性
高内聚低耦合不是只看单个函数，而是整套函数集如何协作。建议按用途分文件，用 source 加载，并提供最小运行上下文。
- 按领域拆分：如
lib/backup.sh、lib/service.sh、lib/network.sh，每个文件内函数职责相近 - 提供空钩子（hook）：如
before_backup()和after_backup()默认为空函数，用户可重定义，不侵入主逻辑 - 支持单元验证：每个函数开头加
[[ "${BASH_SOURCE[0]}" == "${0}" ]] && echo "test: $(backup_mysql_db testdb)"，便于单独调试
