如果你刚开始写 shell 脚本echo 大概率是你敲得最多的命令之一。它做的事情很简单——把字符串打印到终端或者把环境变量的值显示出来。但就是这个看似不起眼的命令引号用错、转义漏掉、变量没展开脚本就能跑出各种莫名其妙的结果。这篇文章我不打算讲手册里抄来的参数表而是从实际使用出发把 echo 输出字符串、环境变量展开、引号区别、转义控制这些细节一次说透。新手看完能直接用老手也能对照检查一下自己有没有漏掉某些边界情况。无论你是刚接触 Linux 的命令行用户还是天天跟 shell 脚本打交道的开发者echo 的这些细节都值得重新过一遍。1. echo 命令的本质输出与返回1.1 命令到底把内容输出到哪里echo 最核心的作用是把参数写到标准输出stdout上。平时你在终端里看到的那些文字其实都是程序往 stdout 写的终端程序再把内容显示出来。理解这一点很重要因为 stdout 是可以被重定向和管道的。比如你写echo hello log.txt内容就不会出现在屏幕上而是写进文件如果你写echo hello | grep hello内容会作为下一个命令的输入传过去。我见过不少新手以为 echo 就是在屏幕上打印东西遇到重定向就懵了实际上 echo 只是负责把内容吐到标准输出你决定它去哪。echo 还存在到底是外部命令还是内建命令的问题。在 bash、zsh 里echo 通常是 shell 内建命令也就是说 shell 自己执行它不开新进程。但系统里也放着一个/bin/echo或/usr/bin/echo外部程序。你可以用type -a echo查看通常第一个是echo is a shell builtin。内建和外部的区别主要在性能和行为细节上后面讲坑的时候会提到。写脚本时默认走的都是 shell 内建的那个 echo。另一个关键点是 echo 的退出状态。只要命令能执行echo 几乎总是返回 0成功除非系统写输出时报错比如磁盘满了或者管道关闭。这也是 echo 不适合做条件判断的原因——你没法靠它判断内容是否被正确处理。1.2 为什么写脚本离不开它echo 在脚本里的地位相当于调试用的 print。我写任何一段稍微复杂的 shell 逻辑第一件事就是往里塞几个 echo 打点把中间变量的值、走到哪个分支、参数传进来是什么全部打到终端或日志里。没有 echo调脚本基本靠猜。它的用途主要有四块给用户提示信息比如echo 开始安装依赖...。输出变量值做调试比如echo HOME$HOME。生成日志内容配合重定向写文件。构造动态文本比如把变量拼进一段话里。这四类场景看着简单但每一类都会踩到引号和转义的坑。下面我就从输出字符串这个最基本的话题开始拆。2. 输出字符串三种写法的实际区别echo 后面跟什么决定了最终输出什么。最基础的分类有三种不带引号、带双引号、带单引号。很多问题的根源就在于把三种混着用、搞不清展开规则。2.1 不带引号空格压缩与通配符展开直接写echo hello world结果是hello world看起来没问题。但你试试echo hello world连续空格会被压缩成一个输出是hello world。因为 shell 在解析命令行时会先把字符串按空格切分成一个个参数再把参数以单个空格为分隔符传给 echo多个空格就这样被吞了。更隐蔽的是通配符问题。假如当前目录下有a.txt和b.txt你执行echo *.txt输出的不是*.txt而是a.txt b.txt。因为 shell 在传给 echo 之前先做了路径展开。同理不带引号时$VAR照样会展开分号;会被当作命令分隔符。比如echo hello; worldshell 会先把 hello 用 echo 执行然后尝试执行world命令多半会报 command not found。所以不带引号的适用场景很窄输出内容确定、不含特殊字符的纯文本。一旦内容里可能有空格、通配符、分号、and 符号就别裸奔了。2.2 双引号保空格、放变量双引号是我用得最多的一种。它和裸写相比最大的区别是保留空格整个内容作为一个参数处理。比如echo hello world会原样输出hello world连续空格不会被压缩。双引号里变量照常展开。nameAlice; echo Hello, $name输出Hello, Alice。命令替换也生效比如echo Date: $(date)会输出当前日期。这非常适合拼接文本比如echo Error: file $file not found。还有一点容易被忽略双引号里反斜杠\的处理。在 bash 的 echo 默认状态下echo a\b输出的就是a\b反斜杠原样保留但如果加-e反斜杠就变成转义引导符。这一点到第 4 节展开。双引号也有挡不住的东西美元符号$和反引号依然会被解释。如果你想把$HOME这串字面文本打出来而不是输出家目录路径用双引号就是错的。2.3 单引号一刀切全字面单引号内shell 不做任何展开变量不展开、命令替换不执行、反斜杠不转义、通配符不展开。你写什么就输出什么。echo $HOME输出$HOMEecho *.txt输出*.txt。单引号里唯一不能直接输入的就是单引号本身。想输出一个单引号字符常见做法是拼一段echo Its ok或者干脆用双引号包起来。这个拼接技巧初看很怪其实就是用单引号包住字面内容、双引号包住那个引号字符。三种方式我整理成一张表方便对照写法空格保留变量展开通配符展开命令替换场景echo hello world否是是是极简单纯文本echo hello world是是否是拼接变量、结果输出echo hello world是否否否字面输出、特殊字符实战建议很简单内容里含变量就用双引号要打字面符号就用单引号裸写只在完全确定内容安全时才用。别小看这个选择脚本里 90% 的 echo 怪问题都出在引号选择上。3. 环境变量输出的完整姿势3.1 输出变量值的基本写法echo 最常见的用途就是看环境变量。你想看 PATH 里都有哪些路径直接echo $PATH想看当前用户家目录echo $HOME。但有很多细节可以讲究。最基础的是直接加美元符号echo $VAR。这样写有一个小隐患如果变量值以空格开头或结尾、或者包含多个连续空格echo 拿到手之后又会被 shell 重新切分。举例来说MSG a b ; echo $MSG输出可能是a b而不是原本的空格。想保留变量的原始格式务必加双引号echo $MSG。所以我个人写调试输出时习惯一律写成echo $VAR避免意外。花括号写法echo ${VAR}在简单场景下和$VAR一样但它有个关键优势能把变量名和后面的字符隔开。比如你有变量num想输出num_v2中的num再加后缀文字直接写echo $num_v2会被解析成变量num_v2写成echo ${num}_v2才能取到num的值再接上_v2。这个坑在拼接文件名时特别常见我踩过不止一次。3.2 变量不存在或为空的情况环境变量不是永远存在的。你执行echo $NOT_EXIST输出结果是一个空行而且 exit code 依然是 0。shell 不会因为变量没定义而报错除非你开启了set -unounset。这对排查很不利脚本里变量拼错了echo 打出来是空行你很难立刻意识到是名字写错。我的习惯是在关键脚本开头加一行set -u这样一旦使用了未定义变量脚本立刻报unbound variable并退出早发现早修。如果你不能全局开启也可以针对单个输出用参数展开的默认值用法echo ${MY_VAR:-not set}变量为空或未定义时输出not set。还有:变体会在变量为空时顺便给它赋值适合后续还要继续用这个变量的场景。另一个点是区分空字符串和未定义。EMPTY之后echo value${EMPTY:-fallback}输出valuefallback如果你用EMPTY但想保留空值本身到后续逻辑就必须用${EMPTY-}这种不带冒号的写法只有未定义时才用默认值。这个冒号的有无代表着空值也算值还是空值默认细节差之毫厘结果谬以千里。3.3 shell 变量与环境变量的关系环境变量和 shell 变量这俩概念经常被混着说。简单讲shell 变量是当前 shell 进程内部的变量环境变量是会传给子进程的变量。你用var100定义一个 shell 变量直接echo $var能输出但如果你在脚本里调用另一个程序那个程序通常看不到var。想让子进程和外部程序看到必须export var100。export会把变量标记为环境变量子进程继承时会带上。这也是很多人调试时遇到的一个经典困惑在终端里export FOObar之后 echo 能输出但另开一个终端窗口 echo 又什么都没了。因为每个终端是独立的 shell 进程export 只在你当前会话里生效不会永久写进某个全局配置。想区分变量是否被导出可以用env命令查看所有环境变量或者set查看当前 shell 的所有变量包含非导出的。配合 echo 排查时我常这样做先echo $FOO看 shell 里有没有再用env | grep ^FOO看是否真的被导出。两者结果不一致说明问题出现在 export 步骤或者配置文件加载顺序上。常见的位置是把 export 写进~/.bashrc、~/.profile或项目专用的 env 文件。写完记得要么重开终端要么source ~/.bashrc手动刷新否则 echo 输出旧值或空值容易误判。4. 换行、转义与格式化输出4.1 默认换行和 -n 参数echo 每次输出完默认会追加一个换行符。这个设计在交互式终端里很自然但在生成文件内容时会让你抓狂。比如你想拼一段没有换行的文本echo -n就是不换行的关键参数。举个例子循环里打印进度做成了单行刷新echo -n Processing...; ...; echo done最终会打出一行Processing... done。如果你忘了-n就会变成Processing...换行再done多出一行正好破坏格式。写日志时也常用-n做连续上下文输出或者配合\r做原地覆盖刷新。-n还有一个作用在不需要换行的提示语后等待输入比如echo -n Input your name: ; read name。这样用户输入的字符会紧跟在冒号后面而不是跑到下一行。需要特别说明的是不同 shell 的 echo 对-n的支持不完全一致。bash 内建的 echo 支持/bin/echo在多数 Linux 发行版上也支持但部分 Unix 或 POSIX 严格模式下可能把-n当成普通字符串输出。如果你要写跨平台脚本这种差异会不期而至。后面讲 printf 时我会给一个更稳的替代方案。4.2 -e 启用转义字符默认情况下bash 的 echo 不会解释反斜杠转义。你写echo a\nb输出的是字面a\nb不是两行。想要\n变成换行必须加-eecho -e a\nb。这个行为和 C 语言的 printf 习惯很不一样是新人最容易踩的点。开启-e后常用的转义序列包括\n换行\t制表符\r回车配合-n或做进度条刷新\\反斜杠本身\a响铃\c截断输出类似-n的效果我写表格对齐输出时常用echo -e Name\tScore不用手敲一堆空格对齐效果好很多。需要强调一点echo -e的行为在 bash 里没问题可一旦脚本用了sh或其他 shell 跑-e可能会被当成普通字符串输出。所以转义优先我建议交给 printf而不是在很多发行版上行为不统一的 echo -e。顺带说一个扩展知识点bash 的echo参数里-n和-e可以合并成echo -en输出时不换行且启用转义。比如echo -en Loading...\r可以做简单的动态等待效果。不过涉及复杂交互进度还是用printf和终端控制序列更靠谱。4.3 用 ANSI 转义序列给输出上颜色终端输出带颜色靠的也是转义字符。核心是用\033[或\e[引入控制序列接数字和字母控制效果。形式通常是\033[样式;前景色;背景色m。举个例子echo -e \033[31mERROR\033[0m其中\033[31m让后面文字变红色\033[0m恢复默认。常见颜色代码30~37 是黑红绿黄蓝紫青白40~47 是对应背景色。样式代码里 1 加粗、4 下划线、5 闪烁终端多半不支持或很丑、7 反显。实际写脚本时我通常不会把颜色硬编码在每行 echo 里而是定义两个变量比如RED\033[31m; RESET\033[0m然后echo -e ${RED}Warning${RESET}。这样要关掉颜色输出时只需要给变量赋空值就行日志重定向到文件时也清爽。这里有个隐蔽问题ANSI 颜色序列在写入文件时会留下一堆不可见字符如果脚本输出要进日志文件建议加一个是否启用颜色的开关变量默认关闭。否则后期 grep 日志会看到满屏的^[[31m这类杂乱内容。5. 实战中的 echo 方案5.1 写一个带时间戳的日志函数把 echo 用在脚本里最值得做的是封装日志函数。直接在脚本里到处写裸 echo问题在于格式不统一、没有时间、没法控制级别。我常用的做法是定义一个log_info和log_error简易函数#!/bin/bash log_info() { echo [$(date %Y-%m-%d %H:%M:%S)] [INFO] $* } log_error() { echo [$(date %Y-%m-%d %H:%M:%S)] [ERROR] $* 2 } log_info start deploy log_error config file missing这里有两个要点一是在$*前双引号否则传进来的多个参数会被重新分词二是错误信息重定向到 stderr2这样正常日志和错误日志可以分开收集。用$*而不是$是为了让所有参数拼成一条消息避免函数内参数边界混乱。为了后续排查方便我还会让log_info支持一个变量控制是否输出到文件还是同时输出到终端。原理不复杂无非是echo ... | tee -a $LOG_FILE原理上一通百通。5.2 对齐输出和简单表格对齐文本用 echo 配合空格很别扭因为你不知道每个字段实际宽度。这时候最常用的是printf但我想先说明用 echo 也能解决一部分问题固定宽度场景下echo -e Name\tScore配合制表符已经能让绝大多数终端对齐。缺点是字段内容超宽时制表符会乱跳。更稳的做法是直接用 printf 的%-Ns格式控制最小宽度。在这里提一个混合用法先用变量拼接好整行再用 echo 输出比如line$(printf %-20s %-10s %s $name $score $status) echo $lineprintf把格式化后的文本赋值给变量echo负责输出。好处是格式化逻辑集中在 printfecho 只做纯输出逻辑干净也绕开了 echo -e 在转义上的各种 shell 差异。如果你要输出的是 CSV 之类机器可读格式我建议完全回避手动对齐只做字段定界echo $name,$score,$status注意字段值里有逗号时先做转义或加引号否则下游解析工具会断开字段。5.3 echo 和 printf到底选谁很多教程会说用 printf 代替 echo但实际项目里 echo 依然遍地都是原因很简单它短、好读、足够应付 80% 场景。我的选择标准是输出普通提示、变量调试、简单日志 → 用 echo。需要格式化对齐、数字补零、固定宽度 → 用 printf。需要可靠跨 shell 的转义 → 用 printf。输出内容含大量特殊字符、难以管理引号 → 用 cat 加 heredoc而不是死磕 echo。printf 的好处是行为高度标准化printf %s\n $VAR在任何 shell 下输出一致。坏处是第一次接触时格式串看着绕眼。我并不是让你放弃 echo 全面转 printf而是建议在脚本的关键输出处、需要稳定行为的场景里多留意一下 printf 这个备选。调试日常echo 管够交付给别人跑的脚本printf 更让人放心。6. 常见问题与排查技巧实录6.1 echo 变量输出是空的这是一个高频问题。写了echo $MY_VAR结果一行空白常见原因按出现频率排序变量名拼错比如定义的是MY_VAR输出时写的$MYVAR。变量在子进程里被设置过但当前 shell 没有 export 或没有 source。配置文件里变量定义在 echo 之后加载顺序不对。变量值本身确实为空比如从某命令结果里赋值但命令失败了。排查时我习惯先declare -p MY_VAR看变量是否定义、值是什么再env | grep MY_VAR确认有没有被导出。两个命令一配合很快能定位到变量到底是没有定义、是空值、还是没导出。另外注意一个 Windows 风格的坑如果你的脚本是从 Windows 编辑保存的每行结尾带着\recho $MY_VAR输出的末尾会莫名多个\r肉眼看不出来但拼进命令或文件名后会让你崩溃。用cat -A script.sh | head -n 20能看到行尾有没有^M$有就需要先执行sed -i s/\r$// script.sh清理。6.2 引号不匹配终端卡住等输入输入echo hello没写闭合双引号回车后终端出现提示符好像卡住了。这个是 shell 在等你把引号补完。很多人第一次遇到以为是死机其实就是引号没闭合。解决方式很简单再输入个闭合的引号然后回车即可。如果已经手忙脚乱可以按CtrlC终止当前输入重新打命令。避免这类问题最有效的习惯是命令里引号成对写。比如先写成echo 再往里面填文本写复杂命令时先用单行测试再贴回脚本统一格式化。6.3 反斜杠和特殊字符被吃掉想输出 Windows 路径C:\Users\name用echo C:\Users\name在 bash 默认状态下大概率没问题但如果开了-e\U这种不认识的转义会被当作\U或U路径就变了。所以开-e时要格外小心反斜杠。反过来你确实想输出一个反斜杠时在-e模式要写成\\。包含$、、!历史扩展这类字符时第一选择是用单引号包整段文本。如果内容里还必须拼变量就只能单双引号按段拼接或者改用 printf 的%s传参这样内容不会被 shell 二次解释。一句话内容越脏越要控住引号边界。6.4 大量 echo 的性能陷阱脚本里写成千上万次 echo 时性能可能出问题但问题往往不在 echo 本身而在死循环里重复启动外部命令。比如在for循环里频繁调用/bin/echo而不是 shell 内建 echo每轮循环都要 fork 一个新进程开销立刻上去。bash 内建 echo 没有进程创建开销性能会好很多。验证方法很简单type -a echo看内建是否存在或者直接用echo瞬间执行一万次对比/bin/echo。我实际测试中内建 echo 跑一万次大约零点几秒外部 echo 要慢好几倍在高频循环里体感明显。更值得优化的是把多次 echo 合并成一次。比如循环拼接字符串在循环里 echo 几千行不如先用变量累积再一次性输出或者用printf -v批量构建。这里不展开讲你只要记住大量输出时控制进程数量和写盘次数比纠结用 echo 还是 printf 重要得多。6.5 排查技巧最后补充几招调试 echo 输出时建议用set -x临时打开追踪模式shell 会把每一条实际执行的命令打印出来。比如你想知道 echo 到底收到什么参数set -x后执行显示的是 echo hello world一眼就能看到变量展开后的真实值。这个技巧对定位引号错误和变量展开问题非常高效。还有cat -A配合文件内容时能看到不可见字符od -c能以字符形式查看输出里到底有什么字节。排查我以为输出是 X实际是 Y的怪问题这几个命令组合起来就是杀手锏。最后分享一个我自己的调试习惯别在复杂脚本里试图一口气把 echo 效果写到完美。先开着set -x裸奔几轮确认变量展开没问题再回头完善颜色、格式和日志级别。另外echo -e这东西虽然方便但跨平台性真的不如 printf交付脚本前最好做一次兼容检查。日常用 echo 图快完全可以但关键时刻多问自己一句这句输出换个 shell 跑还会对吗想清楚这个问题很多坑就不会踩到了。
如果你刚开始写 shell 脚本echo 大概率是你敲得最多的命令之一。它做的事情很简单——把字符串打印到终端或者把环境变量的值显示出来。但就是这个看似不起眼的命令引号用错、转义漏掉、变量没展开脚本就能跑出各种莫名其妙的结果。这篇文章我不打算讲手册里抄来的参数表而是从实际使用出发把 echo 输出字符串、环境变量展开、引号区别、转义控制这些细节一次说透。新手看完能直接用老手也能对照检查一下自己有没有漏掉某些边界情况。无论你是刚接触 Linux 的命令行用户还是天天跟 shell 脚本打交道的开发者echo 的这些细节都值得重新过一遍。1. echo 命令的本质输出与返回1.1 命令到底把内容输出到哪里echo 最核心的作用是把参数写到标准输出stdout上。平时你在终端里看到的那些文字其实都是程序往 stdout 写的终端程序再把内容显示出来。理解这一点很重要因为 stdout 是可以被重定向和管道的。比如你写echo hello log.txt内容就不会出现在屏幕上而是写进文件如果你写echo hello | grep hello内容会作为下一个命令的输入传过去。我见过不少新手以为 echo 就是在屏幕上打印东西遇到重定向就懵了实际上 echo 只是负责把内容吐到标准输出你决定它去哪。echo 还存在到底是外部命令还是内建命令的问题。在 bash、zsh 里echo 通常是 shell 内建命令也就是说 shell 自己执行它不开新进程。但系统里也放着一个/bin/echo或/usr/bin/echo外部程序。你可以用type -a echo查看通常第一个是echo is a shell builtin。内建和外部的区别主要在性能和行为细节上后面讲坑的时候会提到。写脚本时默认走的都是 shell 内建的那个 echo。另一个关键点是 echo 的退出状态。只要命令能执行echo 几乎总是返回 0成功除非系统写输出时报错比如磁盘满了或者管道关闭。这也是 echo 不适合做条件判断的原因——你没法靠它判断内容是否被正确处理。1.2 为什么写脚本离不开它echo 在脚本里的地位相当于调试用的 print。我写任何一段稍微复杂的 shell 逻辑第一件事就是往里塞几个 echo 打点把中间变量的值、走到哪个分支、参数传进来是什么全部打到终端或日志里。没有 echo调脚本基本靠猜。它的用途主要有四块给用户提示信息比如echo 开始安装依赖...。输出变量值做调试比如echo HOME$HOME。生成日志内容配合重定向写文件。构造动态文本比如把变量拼进一段话里。这四类场景看着简单但每一类都会踩到引号和转义的坑。下面我就从输出字符串这个最基本的话题开始拆。2. 输出字符串三种写法的实际区别echo 后面跟什么决定了最终输出什么。最基础的分类有三种不带引号、带双引号、带单引号。很多问题的根源就在于把三种混着用、搞不清展开规则。2.1 不带引号空格压缩与通配符展开直接写echo hello world结果是hello world看起来没问题。但你试试echo hello world连续空格会被压缩成一个输出是hello world。因为 shell 在解析命令行时会先把字符串按空格切分成一个个参数再把参数以单个空格为分隔符传给 echo多个空格就这样被吞了。更隐蔽的是通配符问题。假如当前目录下有a.txt和b.txt你执行echo *.txt输出的不是*.txt而是a.txt b.txt。因为 shell 在传给 echo 之前先做了路径展开。同理不带引号时$VAR照样会展开分号;会被当作命令分隔符。比如echo hello; worldshell 会先把 hello 用 echo 执行然后尝试执行world命令多半会报 command not found。所以不带引号的适用场景很窄输出内容确定、不含特殊字符的纯文本。一旦内容里可能有空格、通配符、分号、and 符号就别裸奔了。2.2 双引号保空格、放变量双引号是我用得最多的一种。它和裸写相比最大的区别是保留空格整个内容作为一个参数处理。比如echo hello world会原样输出hello world连续空格不会被压缩。双引号里变量照常展开。nameAlice; echo Hello, $name输出Hello, Alice。命令替换也生效比如echo Date: $(date)会输出当前日期。这非常适合拼接文本比如echo Error: file $file not found。还有一点容易被忽略双引号里反斜杠\的处理。在 bash 的 echo 默认状态下echo a\b输出的就是a\b反斜杠原样保留但如果加-e反斜杠就变成转义引导符。这一点到第 4 节展开。双引号也有挡不住的东西美元符号$和反引号依然会被解释。如果你想把$HOME这串字面文本打出来而不是输出家目录路径用双引号就是错的。2.3 单引号一刀切全字面单引号内shell 不做任何展开变量不展开、命令替换不执行、反斜杠不转义、通配符不展开。你写什么就输出什么。echo $HOME输出$HOMEecho *.txt输出*.txt。单引号里唯一不能直接输入的就是单引号本身。想输出一个单引号字符常见做法是拼一段echo Its ok或者干脆用双引号包起来。这个拼接技巧初看很怪其实就是用单引号包住字面内容、双引号包住那个引号字符。三种方式我整理成一张表方便对照写法空格保留变量展开通配符展开命令替换场景echo hello world否是是是极简单纯文本echo hello world是是否是拼接变量、结果输出echo hello world是否否否字面输出、特殊字符实战建议很简单内容里含变量就用双引号要打字面符号就用单引号裸写只在完全确定内容安全时才用。别小看这个选择脚本里 90% 的 echo 怪问题都出在引号选择上。3. 环境变量输出的完整姿势3.1 输出变量值的基本写法echo 最常见的用途就是看环境变量。你想看 PATH 里都有哪些路径直接echo $PATH想看当前用户家目录echo $HOME。但有很多细节可以讲究。最基础的是直接加美元符号echo $VAR。这样写有一个小隐患如果变量值以空格开头或结尾、或者包含多个连续空格echo 拿到手之后又会被 shell 重新切分。举例来说MSG a b ; echo $MSG输出可能是a b而不是原本的空格。想保留变量的原始格式务必加双引号echo $MSG。所以我个人写调试输出时习惯一律写成echo $VAR避免意外。花括号写法echo ${VAR}在简单场景下和$VAR一样但它有个关键优势能把变量名和后面的字符隔开。比如你有变量num想输出num_v2中的num再加后缀文字直接写echo $num_v2会被解析成变量num_v2写成echo ${num}_v2才能取到num的值再接上_v2。这个坑在拼接文件名时特别常见我踩过不止一次。3.2 变量不存在或为空的情况环境变量不是永远存在的。你执行echo $NOT_EXIST输出结果是一个空行而且 exit code 依然是 0。shell 不会因为变量没定义而报错除非你开启了set -unounset。这对排查很不利脚本里变量拼错了echo 打出来是空行你很难立刻意识到是名字写错。我的习惯是在关键脚本开头加一行set -u这样一旦使用了未定义变量脚本立刻报unbound variable并退出早发现早修。如果你不能全局开启也可以针对单个输出用参数展开的默认值用法echo ${MY_VAR:-not set}变量为空或未定义时输出not set。还有:变体会在变量为空时顺便给它赋值适合后续还要继续用这个变量的场景。另一个点是区分空字符串和未定义。EMPTY之后echo value${EMPTY:-fallback}输出valuefallback如果你用EMPTY但想保留空值本身到后续逻辑就必须用${EMPTY-}这种不带冒号的写法只有未定义时才用默认值。这个冒号的有无代表着空值也算值还是空值默认细节差之毫厘结果谬以千里。3.3 shell 变量与环境变量的关系环境变量和 shell 变量这俩概念经常被混着说。简单讲shell 变量是当前 shell 进程内部的变量环境变量是会传给子进程的变量。你用var100定义一个 shell 变量直接echo $var能输出但如果你在脚本里调用另一个程序那个程序通常看不到var。想让子进程和外部程序看到必须export var100。export会把变量标记为环境变量子进程继承时会带上。这也是很多人调试时遇到的一个经典困惑在终端里export FOObar之后 echo 能输出但另开一个终端窗口 echo 又什么都没了。因为每个终端是独立的 shell 进程export 只在你当前会话里生效不会永久写进某个全局配置。想区分变量是否被导出可以用env命令查看所有环境变量或者set查看当前 shell 的所有变量包含非导出的。配合 echo 排查时我常这样做先echo $FOO看 shell 里有没有再用env | grep ^FOO看是否真的被导出。两者结果不一致说明问题出现在 export 步骤或者配置文件加载顺序上。常见的位置是把 export 写进~/.bashrc、~/.profile或项目专用的 env 文件。写完记得要么重开终端要么source ~/.bashrc手动刷新否则 echo 输出旧值或空值容易误判。4. 换行、转义与格式化输出4.1 默认换行和 -n 参数echo 每次输出完默认会追加一个换行符。这个设计在交互式终端里很自然但在生成文件内容时会让你抓狂。比如你想拼一段没有换行的文本echo -n就是不换行的关键参数。举个例子循环里打印进度做成了单行刷新echo -n Processing...; ...; echo done最终会打出一行Processing... done。如果你忘了-n就会变成Processing...换行再done多出一行正好破坏格式。写日志时也常用-n做连续上下文输出或者配合\r做原地覆盖刷新。-n还有一个作用在不需要换行的提示语后等待输入比如echo -n Input your name: ; read name。这样用户输入的字符会紧跟在冒号后面而不是跑到下一行。需要特别说明的是不同 shell 的 echo 对-n的支持不完全一致。bash 内建的 echo 支持/bin/echo在多数 Linux 发行版上也支持但部分 Unix 或 POSIX 严格模式下可能把-n当成普通字符串输出。如果你要写跨平台脚本这种差异会不期而至。后面讲 printf 时我会给一个更稳的替代方案。4.2 -e 启用转义字符默认情况下bash 的 echo 不会解释反斜杠转义。你写echo a\nb输出的是字面a\nb不是两行。想要\n变成换行必须加-eecho -e a\nb。这个行为和 C 语言的 printf 习惯很不一样是新人最容易踩的点。开启-e后常用的转义序列包括\n换行\t制表符\r回车配合-n或做进度条刷新\\反斜杠本身\a响铃\c截断输出类似-n的效果我写表格对齐输出时常用echo -e Name\tScore不用手敲一堆空格对齐效果好很多。需要强调一点echo -e的行为在 bash 里没问题可一旦脚本用了sh或其他 shell 跑-e可能会被当成普通字符串输出。所以转义优先我建议交给 printf而不是在很多发行版上行为不统一的 echo -e。顺带说一个扩展知识点bash 的echo参数里-n和-e可以合并成echo -en输出时不换行且启用转义。比如echo -en Loading...\r可以做简单的动态等待效果。不过涉及复杂交互进度还是用printf和终端控制序列更靠谱。4.3 用 ANSI 转义序列给输出上颜色终端输出带颜色靠的也是转义字符。核心是用\033[或\e[引入控制序列接数字和字母控制效果。形式通常是\033[样式;前景色;背景色m。举个例子echo -e \033[31mERROR\033[0m其中\033[31m让后面文字变红色\033[0m恢复默认。常见颜色代码30~37 是黑红绿黄蓝紫青白40~47 是对应背景色。样式代码里 1 加粗、4 下划线、5 闪烁终端多半不支持或很丑、7 反显。实际写脚本时我通常不会把颜色硬编码在每行 echo 里而是定义两个变量比如RED\033[31m; RESET\033[0m然后echo -e ${RED}Warning${RESET}。这样要关掉颜色输出时只需要给变量赋空值就行日志重定向到文件时也清爽。这里有个隐蔽问题ANSI 颜色序列在写入文件时会留下一堆不可见字符如果脚本输出要进日志文件建议加一个是否启用颜色的开关变量默认关闭。否则后期 grep 日志会看到满屏的^[[31m这类杂乱内容。5. 实战中的 echo 方案5.1 写一个带时间戳的日志函数把 echo 用在脚本里最值得做的是封装日志函数。直接在脚本里到处写裸 echo问题在于格式不统一、没有时间、没法控制级别。我常用的做法是定义一个log_info和log_error简易函数#!/bin/bash log_info() { echo [$(date %Y-%m-%d %H:%M:%S)] [INFO] $* } log_error() { echo [$(date %Y-%m-%d %H:%M:%S)] [ERROR] $* 2 } log_info start deploy log_error config file missing这里有两个要点一是在$*前双引号否则传进来的多个参数会被重新分词二是错误信息重定向到 stderr2这样正常日志和错误日志可以分开收集。用$*而不是$是为了让所有参数拼成一条消息避免函数内参数边界混乱。为了后续排查方便我还会让log_info支持一个变量控制是否输出到文件还是同时输出到终端。原理不复杂无非是echo ... | tee -a $LOG_FILE原理上一通百通。5.2 对齐输出和简单表格对齐文本用 echo 配合空格很别扭因为你不知道每个字段实际宽度。这时候最常用的是printf但我想先说明用 echo 也能解决一部分问题固定宽度场景下echo -e Name\tScore配合制表符已经能让绝大多数终端对齐。缺点是字段内容超宽时制表符会乱跳。更稳的做法是直接用 printf 的%-Ns格式控制最小宽度。在这里提一个混合用法先用变量拼接好整行再用 echo 输出比如line$(printf %-20s %-10s %s $name $score $status) echo $lineprintf把格式化后的文本赋值给变量echo负责输出。好处是格式化逻辑集中在 printfecho 只做纯输出逻辑干净也绕开了 echo -e 在转义上的各种 shell 差异。如果你要输出的是 CSV 之类机器可读格式我建议完全回避手动对齐只做字段定界echo $name,$score,$status注意字段值里有逗号时先做转义或加引号否则下游解析工具会断开字段。5.3 echo 和 printf到底选谁很多教程会说用 printf 代替 echo但实际项目里 echo 依然遍地都是原因很简单它短、好读、足够应付 80% 场景。我的选择标准是输出普通提示、变量调试、简单日志 → 用 echo。需要格式化对齐、数字补零、固定宽度 → 用 printf。需要可靠跨 shell 的转义 → 用 printf。输出内容含大量特殊字符、难以管理引号 → 用 cat 加 heredoc而不是死磕 echo。printf 的好处是行为高度标准化printf %s\n $VAR在任何 shell 下输出一致。坏处是第一次接触时格式串看着绕眼。我并不是让你放弃 echo 全面转 printf而是建议在脚本的关键输出处、需要稳定行为的场景里多留意一下 printf 这个备选。调试日常echo 管够交付给别人跑的脚本printf 更让人放心。6. 常见问题与排查技巧实录6.1 echo 变量输出是空的这是一个高频问题。写了echo $MY_VAR结果一行空白常见原因按出现频率排序变量名拼错比如定义的是MY_VAR输出时写的$MYVAR。变量在子进程里被设置过但当前 shell 没有 export 或没有 source。配置文件里变量定义在 echo 之后加载顺序不对。变量值本身确实为空比如从某命令结果里赋值但命令失败了。排查时我习惯先declare -p MY_VAR看变量是否定义、值是什么再env | grep MY_VAR确认有没有被导出。两个命令一配合很快能定位到变量到底是没有定义、是空值、还是没导出。另外注意一个 Windows 风格的坑如果你的脚本是从 Windows 编辑保存的每行结尾带着\recho $MY_VAR输出的末尾会莫名多个\r肉眼看不出来但拼进命令或文件名后会让你崩溃。用cat -A script.sh | head -n 20能看到行尾有没有^M$有就需要先执行sed -i s/\r$// script.sh清理。6.2 引号不匹配终端卡住等输入输入echo hello没写闭合双引号回车后终端出现提示符好像卡住了。这个是 shell 在等你把引号补完。很多人第一次遇到以为是死机其实就是引号没闭合。解决方式很简单再输入个闭合的引号然后回车即可。如果已经手忙脚乱可以按CtrlC终止当前输入重新打命令。避免这类问题最有效的习惯是命令里引号成对写。比如先写成echo 再往里面填文本写复杂命令时先用单行测试再贴回脚本统一格式化。6.3 反斜杠和特殊字符被吃掉想输出 Windows 路径C:\Users\name用echo C:\Users\name在 bash 默认状态下大概率没问题但如果开了-e\U这种不认识的转义会被当作\U或U路径就变了。所以开-e时要格外小心反斜杠。反过来你确实想输出一个反斜杠时在-e模式要写成\\。包含$、、!历史扩展这类字符时第一选择是用单引号包整段文本。如果内容里还必须拼变量就只能单双引号按段拼接或者改用 printf 的%s传参这样内容不会被 shell 二次解释。一句话内容越脏越要控住引号边界。6.4 大量 echo 的性能陷阱脚本里写成千上万次 echo 时性能可能出问题但问题往往不在 echo 本身而在死循环里重复启动外部命令。比如在for循环里频繁调用/bin/echo而不是 shell 内建 echo每轮循环都要 fork 一个新进程开销立刻上去。bash 内建 echo 没有进程创建开销性能会好很多。验证方法很简单type -a echo看内建是否存在或者直接用echo瞬间执行一万次对比/bin/echo。我实际测试中内建 echo 跑一万次大约零点几秒外部 echo 要慢好几倍在高频循环里体感明显。更值得优化的是把多次 echo 合并成一次。比如循环拼接字符串在循环里 echo 几千行不如先用变量累积再一次性输出或者用printf -v批量构建。这里不展开讲你只要记住大量输出时控制进程数量和写盘次数比纠结用 echo 还是 printf 重要得多。6.5 排查技巧最后补充几招调试 echo 输出时建议用set -x临时打开追踪模式shell 会把每一条实际执行的命令打印出来。比如你想知道 echo 到底收到什么参数set -x后执行显示的是 echo hello world一眼就能看到变量展开后的真实值。这个技巧对定位引号错误和变量展开问题非常高效。还有cat -A配合文件内容时能看到不可见字符od -c能以字符形式查看输出里到底有什么字节。排查我以为输出是 X实际是 Y的怪问题这几个命令组合起来就是杀手锏。最后分享一个我自己的调试习惯别在复杂脚本里试图一口气把 echo 效果写到完美。先开着set -x裸奔几轮确认变量展开没问题再回头完善颜色、格式和日志级别。另外echo -e这东西虽然方便但跨平台性真的不如 printf交付脚本前最好做一次兼容检查。日常用 echo 图快完全可以但关键时刻多问自己一句这句输出换个 shell 跑还会对吗想清楚这个问题很多坑就不会踩到了。
