讲师中心 微信公众号
AI工具推荐 视频效率加速

Linux shell 调试技巧与错误处理

冬磊君_5560

冬磊君_5560

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

|

251人浏览过

|

来源于php中文网

原创

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

linux shell 调试技巧与错误处理

用 set -e 和 set -u 让脚本自动失败而不是硬扛

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

  • 加在脚本开头:直接写 set -euo pipefail(pipefail 确保管道中任一环节失败都算整体失败)
  • 别在交互式 shell 里全局启用,它会干扰日常命令;只在脚本内启用
  • 临时绕过某行:用 command || true 或 set +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 看它实际调了啥系统调用
  • which 和 type -a 必须查两遍:which ls 可能返回 alias,type -a ls 才显示 alias / function / binary 优先级
  • 注意子 shell 影响:(cd /tmp; pwd) 里的 cd 失败不会影响外层,$? 也捕获不到

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

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

Linux Ai Server
Linux Ai Server

Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI,零 GUI 开销。

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

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

热门AI工具

更多
二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

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

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

549

2023.09.22

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

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

1698

2024.03.01

string转int
string转int

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

6479

2023.08.02

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

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

3145

2024.08.29

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

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

4048

2025.08.29

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

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

2785

2025.08.29

function是什么
function是什么

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

3160

2023.08.04

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

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

534

2023.10.07

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn