应将重复逻辑封装为 Shell 函数以提升复用性与可维护性，具体包括：基础定义调用、函数文件分离、参数校验、局部变量隔离及模块化命名规范。
如果您希望在多个 Shell 脚本中重复使用某段逻辑，避免代码冗余与维护困难，则需要将该逻辑封装为可调用的函数。以下是实现 Linux Shell 函数封装与脚本复用的设计方法：
一、基础函数定义与调用
Shell 函数通过 function 关键字或直接使用函数名加括号的方式声明，其 作用域 默认为当前脚本，便于局部逻辑抽象和复用。
1、在脚本开头或逻辑块前定义函数，语法为：函数名（) { 命令序列；}
2、在脚本任意位置调用该函数，仅需写入函数名并传入参数，如：my_log “info” “service started”
3、函数内使用 $1、$2 等访问参数，使用 $# 获取参数个数，使用 $? 捕获上一条命令退出状态。
二、函数文件分离与 source 引入
将常用函数集中存放在独立的。sh 文件中，通过 source 命令加载，实现跨脚本共享，避免重复定义。
1、新建公共函数文件 lib_utils.sh，内容包含多个函数定义，如log_info()、check_file_exists() 等。
2、在主脚本顶部添加：source ./lib_utils.sh
3、确保 lib_utils.sh 具有读取权限：chmod +r lib_utils.sh
三、参数校验与错误处理封装
为提升函数健壮性，将参数合法性检查与错误响应逻辑统一封装，使各业务函数调用时自动具备防御能力。
1、定义通用校验函数require_arg()，接收参数名与实际值，若为空则打印错误并退出。
2、在业务函数内部首行调用：require_arg “config_path” “$1”
3、设置 set -e 使脚本在任一命令失败时终止，配合函数内 return 1 实现可控中断。
四、环境隔离与作用域控制
使用 local 关键字声明变量，防止函数内部变量污染全局命名空间，保障多函数并发调用时的状态独立性。
1、在函数体起始处声明所需局部变量：local result timeout_val
2、对所有非返回值用途的中间变量均加 local 前缀，包括循环计数器、临时路径等。
3、避免在函数中直接修改全局变量，如需输出结果，统一通过 echo 返回，并由调用方用 $(……) 捕获。
五、模块化函数分组与命名规范
按功能领域对函数分类命名，采用前缀 + 动词 + 名词结构，增强可读性与可检索性，支撑大型脚本工程化组织。
1、网络相关函数统一以 net_ 开头，如net_wait_port()、net_is_reachable()。
2、文件操作函数以 fs_ 开头，如fs_backup_file()、fs_ensure_dir()。
3、在函数注释头部标明用途、参数说明及示例调用，格式为：# @desc: 检查 端口 是否就绪；@param: $1=host $2=port；@example: net_wait_port localhost 8080
