Shell函数编写规范

一、函数命名规范

函数名应该简洁而明确，可以由英文字母、数字、下划线组成，应该以字母开头，并且不应该与Shell的保留字冲突。建议使用小写字母，以便与环境变量作区分。例如：

function my_function() {
    # code here
}

若函数名由多个单词组成，可以使用驼峰命名法或下划线分隔符，但**不建议使用中划线分隔符**，以免被误认为是参数选项。例如：

function myFunctionName() {
    # code here
}

function my_function_name() {
    # code here
}

二、函数调用规范

在Shell脚本中调用函数时，可以直接使用函数名进行调用。若函数有返回值，可以使用变量接收函数的返回值，例如：

function return_something() {
    local str="Hello World"
    return "这是函数的返回值：$str"
}

result=$(return_something)
echo $result

三、函数参数规范

函数可以具有参数，其中$1、$2、$3等表示函数的第1个、第2个、第3个参数，$#表示函数的参数个数，$0表示函数名，例如：

function my_function() {
    echo "这是第1个参数：$1"
    echo "这是第2个参数：$2"
    echo "这是第3个参数：$3"
    echo "参数个数为：$#"
    echo "函数名为：$0"
}

my_function arg1 arg2 arg3

四、代码注释规范

函数中的代码应该加上注释，以便提高代码的可读性和可维护性。注释应该清晰明了，可以包含函数的参数、返回值、功能、实现等信息。例如：

# 这是一个示例函数，接收两个参数并输出它们之间的范围
# 参数1：$1，表示下限
# 参数2：$2，表示上限
# 返回值：无
function range() {
    local min=$1
    local max=$2
    for i in $(seq $min $max); do
        echo $i
    done
}

五、错误处理规范

函数在执行过程中可能会出现各种错误，例如参数错误、文件不存在等。为了提高函数的健壮性，应该加上错误处理机制，例如：

# 这是一个示例函数，接收一个文件名作为参数，如果文件不存在就输出错误信息并返回1
# 参数1：$1，表示文件名
# 返回值：0表示文件存在，1表示文件不存在
function check_file_exist() {
    local file=$1
    if [ ! -f $file ]; then
        echo "文件不存在：$file"
        return 1
    fi
    return 0
}

六、内置函数禁止覆盖规范

Shell自带许多内置函数，例如echo、cd、rm等，为了防止覆盖这些函数，应该避免使用和这些函数相同的函数名。如果确实需要使用内置函数的同名函数，可以使用命令来调用内置函数，例如：

function echo() {
    command echo "这是自定义的echo函数"
}

echo "hello world"  # 调用自定义的echo函数
command echo "hello world"  # 调用原生的echo函数

七、局部变量声明规范

为了防止变量名冲突和提高代码的可维护性，应该在函数中显式地声明局部变量，并使用local关键字进行声明。例如：

function my_function() {
    local var1=1
    local var2=2
    echo "var1=$var1 var2=$var2"
}

my_function

八、代码缩进规范

为了提高代码的可读性和可维护性，应该在代码中使用适当的缩进，使代码结构清晰。一般来说，每个代码块都应该缩进4个空格，或者一个TAB键的距离。例如：

function my_function() {
    for i in $(seq 1 10); do
        if [ $i -eq 5 ]; then
            echo "i等于5"
        else
            echo "i不等于5"
        fi
    done
}

my_function

九、代码风格规范

为了提高代码的可读性和可维护性，应该遵循一定的代码风格规范，例如：

• 代码缩进应该规范，一般使用4个空格或TAB键。
• 代码块应该使用`{}`进行包裹，且左括号应该放在行末，右括号应该放在新的一行。
• 代码中应该避免使用无用的空格和空行。
• 代码中应该尽量使用双引号，防止变量的意外替换。

下面是一个符合代码风格规范的示例：

function my_function() {
    local var1="hello"
    local var2="world"
    if [ $var1 = "hello" ]; then
        echo "$var1 $var2"
    fi
}

my_function