0

0

Linux shell 调试技巧与错误处理

舞夢輝影

舞夢輝影

发布时间:2026-02-16 14:27:04

|

191人浏览过

|

来源于php中文网

原创

启用 set -euo pipefail 可让脚本在命令失败或变量未定义时立即终止,暴露80%低级错误;配合 strace、$? 检查、stderr 调试日志及合理 trap 清理,大幅提升可调试性与健壮性。

linux shell 调试技巧与错误处理

set -eset -u 让脚本自动失败而不是硬扛

脚本静默跳过错误、变量未定义却继续执行——这是最隐蔽的调试噩梦。set -e 让任何命令非零退出时立即终止,set -u 在引用未声明变量时报错,两者合用能暴露 80% 的低级疏漏。

  • 加在脚本开头:直接写 set -euo pipefailpipefail 确保管道中任一环节失败都算整体失败)
  • 别在交互式 shell 里全局启用,它会干扰日常命令;只在脚本内启用
  • 临时绕过某行:用 command || trueset +e 配合 set -e 恢复,但要加注释说明原因
  • set -u${var:-default} 是安全的,但 $var 直接引用未定义变量会炸

定位「命令没执行」的真实原因:检查 $?strace

看到脚本卡住或结果不对,第一反应不该是重跑,而是确认上一条命令到底有没有成功、有没有被信号中断、甚至有没有被 alias 劫持。

  • 紧接关键命令后加 echo "exit code: $?",比猜快十倍
  • 怀疑命令行为异常?用 strace -f -e trace=execve,openat,read,write <code>your_script.sh 看它实际调了啥系统调用
  • whichtype -a 必须查两遍:which ls 可能返回 alias,type -a ls 才显示 alias / function / binary 优先级
  • 注意子 shell 影响:(cd /tmp; pwd) 里的 cd 失败不会影响外层,$? 也捕获不到

日志和调试输出别混在一起:用 exec 重定向 stderr 到文件

把调试信息 echo 到 stdout,结果被管道吞掉或和正常输出搅成一团——这是日志设计最常翻车的地方。真正的调试输出必须走 stderr,且最好单独落盘。

10分钟内自己学会PHP
10分钟内自己学会PHP

10分钟内自己学会PHP其中,第1篇为入门篇,主要包括了解PHP、PHP开发环境搭建、PHP开发基础、PHP流程控制语句、函数、字符串操作、正则表达式、PHP数组、PHP与Web页面交互、日期和时间等内容;第2篇为提高篇,主要包括MySQL数据库设计、PHP操作MySQL数据库、Cookie和Session、图形图像处理技术、文件和目录处理技术、面向对象、PDO数据库抽象层、程序调试与错误处理、A

下载
  • 开头加 exec 2> /tmp/script-debug.log,所有 echo "debug: xxx" 默认进文件(记得加 2>&1 如果要用 echo 写 stderr)
  • 不要用 echo "msg" >> debug.log 多次打开文件,竞态下可能丢行;exec 一次重定向更稳
  • 生产环境关调试?把 exec 2>/dev/null 放条件分支里,别删代码
  • 时间戳很重要:用 echo "$(date '+%T') debug: xxx" >&2,不然多行日志分不清先后

处理信号和中断:trap 不是摆设,但别乱用 EXIT

脚本被 Ctrl+C 杀掉后残留临时文件、锁没释放、进程没清理——不是“运气不好”,是没认真对待信号。

  • trap 'rm -f /tmp/mylock' INT TERMtrap 'rm -f /tmp/mylock' EXIT 更可靠,因为 EXITset -e 中断时不触发
  • trap 后面的命令要写完整路径(如 /bin/rm),避免依赖 $PATH 或被 alias 干扰
  • 调试时加 trap 'echo "TRAPPED: $?"' ERR,能快速发现哪行悄无声息失败了
  • 别在 trap 里调用复杂函数或外部命令,超时或死锁会让整个清理流程卡住

真正难的不是写 trap,是想清楚哪些资源必须清理、哪些信号必须捕获、哪些清理动作本身不能失败——这些细节不画流程图很容易漏

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

244

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

746

2024.03.01

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

750

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

568

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

234

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

209

2025.08.29

function是什么
function是什么

function是函数的意思,是一段具有特定功能的可重复使用的代码块,是程序的基本组成单元之一,可以接受输入参数,执行特定的操作,并返回结果。本专题为大家提供function是什么的相关的文章、下载、课程内容,供大家免费下载体验。

493

2023.08.04

js函数function用法
js函数function用法

js函数function用法有:1、声明函数;2、调用函数;3、函数参数;4、函数返回值;5、匿名函数;6、函数作为参数;7、函数作用域;8、递归函数。本专题提供js函数function用法的相关文章内容,大家可以免费阅读。

166

2023.10.07

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

145

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 9.1万人学习

Git 教程
Git 教程

共21课时 | 3.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号