掌握Shell脚本中的日志艺术（从零开始学会在Linux Shell函数中实现高效日志记录）

为什么需要日志记录？

想象一下：你的脚本在半夜自动运行失败了，但你没有任何线索知道哪里出了问题。这时候，如果没有日志，排查错误将如同大海捞针。而通过合理的 Shell日志记录，你可以清楚地看到每一步执行的状态、变量值、错误信息等，大大提升 Shell脚本调试 效率。

基础日志函数设计

我们可以创建一个通用的日志函数，用于在脚本任何地方调用。这个函数可以接收日志级别（如 INFO、ERROR、WARN）和消息内容，并将其输出到终端或写入日志文件。

#!/bin/bash# 定义日志函数log() {    local level=$1    local message=$2    local timestamp=$(date '+%Y-%m-%d %H:%M:%S')    echo "[$timestamp] [$level] $message"}# 使用示例log "INFO" "脚本开始执行"log "WARN" "检测到配置文件缺失，使用默认设置"log "ERROR" "无法连接数据库"

上面的代码定义了一个简单的 log 函数，它会打印带时间戳和级别的日志信息。这种做法非常适合初学者上手。

进阶：将日志写入文件

在实际生产环境中，我们通常希望日志被持久化保存。下面是一个支持写入日志文件的增强版函数：

#!/bin/bashLOG_FILE="/var/log/my_script.log"log_to_file() {    local level=$1    local message=$2    local timestamp=$(date '+%Y-%m-%d %H:%M:%S')    echo "[$timestamp] [$level] $message" | tee -a "$LOG_FILE"}# 使用示例log_to_file "INFO" "任务启动"log_to_file "ERROR" "磁盘空间不足"

这里使用了 tee 命令，既能输出到终端，又能追加写入日志文件，方便实时监控和后期分析。注意确保脚本有权限写入指定的日志路径。

日志级别控制与过滤

为了更灵活地管理日志输出，我们可以引入日志级别变量，只输出高于设定级别的日志：

#!/bin/bashLOG_LEVEL=2  # 0=ERROR, 1=WARN, 2=INFO, 3=DEBUGLOG_FILE="/tmp/script_debug.log"log_with_level() {    local msg_level=$1    local message=$2    local level_num    case $msg_level in        "ERROR") level_num=0 ;;        "WARN")  level_num=1 ;;        "INFO")  level_num=2 ;;        "DEBUG") level_num=3 ;;        *)       level_num=0 ;;    esac    if [ $level_num -le $LOG_LEVEL ]; then        local timestamp=$(date '+%Y-%m-%d %H:%M:%S')        echo "[$timestamp] [$msg_level] $message" >> "$LOG_FILE"    fi}# 示例：只有当 LOG_LEVEL >= 2 时才会记录log_with_level "INFO" "正在处理用户数据"log_with_level "DEBUG" "变量 user_id = 12345"

通过调整 LOG_LEVEL 的值，你可以轻松控制日志的详细程度，这在 日志管理 中非常实用。

小贴士

• 始终使用 local 变量避免污染全局命名空间。
• 日志文件应定期轮转（rotate），防止占用过多磁盘空间。
• 敏感信息（如密码）切勿写入日志！
• 结合 set -e 和日志，可在脚本出错时自动记录并退出。

结语

通过本文的学习，你应该已经掌握了在 Linux Shell函数 中实现基本到进阶的日志记录方法。良好的日志习惯不仅能让你的脚本更健壮，也能为团队协作和系统运维打下坚实基础。赶快在你的下一个 Shell 项目中实践这些技巧吧！