如何可靠检测输出环境是否支持彩色输出？

我有一个脚本，希望尽可能使用彩色输出，而非仅当STDOUT指向TTY时才使用。目前遇到的检测问题如下：

测试脚本 #

#!/bin/bash

test -t 1 || echo "This is not STDOUT on tty."
echo "colors support: $(tput colors)"
echo "color: $(tput setaf 1)RED"

三种测试场景 #

1. 正常运行（RED显示为红色）

$ ./tput.sh

colors support: 256
color: RED

2. 通过watch运行（彩色失效，但检测到非TTY）

$ watch ./tput.sh

This is not STDOUT on tty.
colors support: 256
color: ^[31mRED

3. 使用watch -c运行（虽非TTY但RED显示为红色）

$ watch -c ./tput.sh

This is not STDOUT on tty.
colors support: 256
color: RED

仅用test -t无法准确判断，因为存在非TTY但支持彩色的情况；而tput colors在三种场景下均检测到支持，完全无用。需要更可靠的检测方式。

可以结合以下几种方式组合判断，覆盖更多场景：

1. 优先遵循NO_COLOR标准 #

如果用户设置了NO_COLOR环境变量（无论具体值是什么），直接禁用彩色输出——这是行业通用的用户偏好约定，优先尊重用户明确选择。

use_colors=1
if [[ -n "$NO_COLOR" ]]; then
  use_colors=0
fi

2. 结合TTY检测与工具环境变量 #

像watch -c这类工具会通过环境变量告知下游脚本可以输出彩色，同时可以通过TERM变量判断终端类型是否支持彩色解析：

• 若STDOUT是TTY，直接启用彩色
• 非TTY场景下，检查是否存在WATCH_COLORS（watch -c会设置该变量），或TERM包含color/256color关键词（比如tmux、less -R这类环境）

示例检测逻辑：

# 先处理NO_COLOR
use_colors=1
if [[ -n "$NO_COLOR" ]]; then
  use_colors=0
else
  # 检测TTY或支持彩色的非TTY环境
  if test -t 1; then
    use_colors=1
  elif [[ -n "$WATCH_COLORS" || "$TERM" =~ (color|256color) ]]; then
    use_colors=1
  else
    use_colors=0
  fi
fi

# 定义彩色变量
if [[ $use_colors -eq 1 ]]; then
  RED=$(tput setaf 1)
  RESET=$(tput sgr0)
else
  RED=""
  RESET=""
fi

echo "color: ${RED}RED${RESET}"

3. 支持用户手动强制控制 #

给脚本添加--color/--no-color参数，让用户可以直接指定是否启用彩色，这是最直接可靠的方式：

use_colors=1

# 解析命令行参数
while [[ $# -gt 0 ]]; do
  case "$1" in
    --color) use_colors=1; shift ;;
    --no-color) use_colors=0; shift ;;
    *) shift ;;
  esac
done

# 后续彩色逻辑同上

补充说明 #

• tput colors的作用是检测当前TERM定义的终端颜色支持数，而非实际输出目标是否能解析彩色转义序列，所以它无法判断输出通道的处理能力。
• watch不加-c时会过滤转义序列，导致彩色代码变成可见字符；加-c时会保留转义序列并传递给终端，此时脚本的彩色输出能被正确渲染。

内容的提问来源于stack exchange，提问作者Albert Camu