シェルスクリプトでtputを使ってターミナル出力を色分けする設計｜ANSIコード直書きを避けて可搬性の高いカラー出力を実装する方法

この記事のポイント

・ tput は terminfo を参照して端末種別ごとに適切なエスケープコードを生成する
・ カラー変数をスクリプト冒頭に宣言し、log_error 等の関数に集約して再利用する
・ [ -t 1 ] と tput colors で非対話環境を検出し、色変数を空文字にしてクリーンな出力を保つ
・ trap で EXIT 時に必ずリセットシーケンスを送り、プロンプト着色を防ぐ

# ANSI コードの直書き（非推奨）
echo -e "\e[31mERROR: ディスク容量不足\e[0m"

# tput を使った書き方（推奨）
RED=$(tput setaf 1)
RESET=$(tput sgr0)
echo "${RED}ERROR: ディスク容量不足${RESET}"

$ tput colors
256

# 組み合わせ例（黄色の太字）
echo "$(tput setaf 3)$(tput bold)WARNING: 重要な警告$(tput sgr0)"
echo "$(tput smul)アンダーラインテキスト$(tput rmul)"

# カラー変数（スクリプト冒頭で宣言）
RED=$(tput setaf 1)
GREEN=$(tput setaf 2)
YELLOW=$(tput setaf 3)
CYAN=$(tput setaf 6)
BOLD=$(tput bold)
RESET=$(tput sgr0)

log_info()  { echo "${CYAN}[INFO]${RESET}  $*"; }
log_ok()    { echo "${GREEN}[OK]${RESET}    $*"; }
log_warn()  { echo "${YELLOW}[WARN]${RESET}  $*" >&2; }
log_error() { echo "${RED}${BOLD}[ERROR]${RESET} $*" >&2; }

$ log_info "バックアップ開始: /var/www/html"
[INFO]  バックアップ開始: /var/www/html
$ log_ok "完了: /backup/html_20261012.tar.gz"
[OK]    完了: /backup/html_20261012.tar.gz
$ log_warn "/backup の使用率が 85% を超えています"
[WARN]  /backup の使用率が 85% を超えています
$ log_error "rsync が終了コード 23 で失敗しました"
[ERROR] rsync が終了コード 23 で失敗しました

# 標準出力が端末かどうかを判定
if [ -t 1 ]; then
    echo "対話ターミナルで実行中"
else
    echo "パイプまたはリダイレクト中（cron を含む）"
fi

# tput が使用可能かチェック（終了コード 0 かつ色数が 8 以上か）
if tput colors 2>/dev/null && [ "$(tput colors)" -ge 8 ]; then
    echo "カラー出力を有効化"
else
    echo "カラーなしで実行"
fi

#!/bin/bash
# color_lib.sh - tput カラー出力ライブラリ（フォールバック対応版）

# 対話ターミナルかつ tput が使えるときだけカラーを有効化
if [ -t 1 ] && tput colors 2>/dev/null && [ "$(tput colors)" -ge 8 ]; then
    RED=$(tput setaf 1)
    GREEN=$(tput setaf 2)
    YELLOW=$(tput setaf 3)
    CYAN=$(tput setaf 6)
    BOLD=$(tput bold)
    RESET=$(tput sgr0)
else
    # 非対話環境ではすべて空文字にしてクリーンな出力を維持
    RED="" GREEN="" YELLOW="" CYAN="" BOLD="" RESET=""
fi

log_info()  { echo "${CYAN}[INFO]${RESET}  $*"; }
log_ok()    { echo "${GREEN}[OK]${RESET}    $*"; }
log_warn()  { echo "${YELLOW}[WARN]${RESET}  $*" >&2; }
log_error() { echo "${RED}${BOLD}[ERROR]${RESET} $*" >&2; }

#!/bin/bash
set -euo pipefail

# カラーライブラリを読み込む
source /usr/local/lib/color_lib.sh

# EXIT 時に必ずリセットシーケンスを送る（プロンプト着色の防止）
trap 'printf "%s" "${RESET}"' EXIT

BACKUP_SRC="/var/www/html"
BACKUP_DEST="/backup"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
OUTFILE="${BACKUP_DEST}/html_${TIMESTAMP}.tar.gz"

log_info "バックアップ開始: ${BACKUP_SRC}"

if tar -czf "${OUTFILE}" "${BACKUP_SRC}" 2>/dev/null; then
    SIZE=$(du -sh "${OUTFILE}" | cut -f1)
    log_ok "完了: ${OUTFILE} (${SIZE})"
else
    log_error "tar が失敗しました（終了コード: $?）"
    exit 1
fi

# /var/log/backup.log（cron 実行・色コードなし）
[INFO]  バックアップ開始: /var/www/html
[OK]    完了: /backup/html_20261012_020001.tar.gz (124M)

export TERM=xterm-256color

RED=$(tput -T xterm-256color setaf 1)

# 確認
echo $TERM          # xterm-256color になっているか
tput colors         # 256 が表示されれば OK

# 修正
export TERM=xterm-256color

# スクリプト冒頭に追加しておくと終了時に必ずリセットされる
trap 'printf "%s" "${RESET}"' EXIT