详解bash中的脚本调试机制

作者:1996scarlet 时间:2023-10-11 03:01:04 

以调试模式运行脚本

通过bash -x <script>的方式可以在调试模式下运行整个脚本, bash会在在运行前打印出了每一行命令, 而且每行前面用+号表明命令的嵌套层数.


> bash -x debug.sh
+ echo 'First line'
First line # 输出结果没有加号
++ date # 先执行命令替换 两个加号是因为该命令嵌套在echo中
+ echo 'Print datetime: Thu 26 Mar 2020 08:21:28 PM CST Done.'
Print datetime: Thu 26 Mar 2020 08:21:28 PM CST Done.

如果脚本比较复杂, 我们可以通过使用环境变量PS4配合调试用的内置变量用于输出更加详细的信息:


> export PS4='+${BASH_SOURCE}:${LINENO}:${FUNCNAME[0]}: '
> bash -x debug.sh
+debug.sh:3:: echo 'First line'
First line
++debug.sh:4:: date
+debug.sh:4:: echo 'Print datetime: Thu 26 Mar 2020 08:35:59 PM CST Done.'
Print datetime: Thu 26 Mar 2020 08:35:59 PM CST Done.

我们也可以使用trap的DEBUG关键字在解释执行每一行脚本之前执行指定的命令或函数:


trap 'echo "VARIABLE-TRACE> \$variable = \"$variable\""' DEBUG
variable=29
let variable++
let variable*=5
exit 0

# 输出如下
VARIABLE-TRACE> $variable = ""
VARIABLE-TRACE> $variable = "29"
VARIABLE-TRACE> $variable = "30"
VARIABLE-TRACE> $variable = "150"

还可以使用trap的ERR关键字用于在解释出现错误时执行预设的操作, 例如打印出错的命令:


trap 'echo $BASH_COMMAND' ERR

但鉴于使用trap进行调试的执行效率过低, 建议在较为复杂的脚本中直接使用调试选项或者使用bashdb等调试工具.

高级调试

查看函数调用信息

在函数中使用内置命令caller能够把函数的调用信息输出到stdout, 但要注意该命令必须在函数内部调用.


#!/usr/bin/bash

func1 () {
 for i in `seq 0 3`
 do
   echo -e "Level$i\t  `caller $i`"
 done
}

func2 () {
 func1
}

func3 () {
 func2
}

func3
caller 0 # 必须在函数中调用 否则无输出
exit 0

运行该脚本可以得到以下输出:

Level0      11 func2 call.sh  # func1 的直接调用者
Level1      15 func3 call.sh  # 一层间接调用
Level2      18 main call.sh   # 二层间接调用
Level3      # 无输出 因为没有第三层调用

局部调试

可以通过set命令构造局部调试块,我们可以按照如下方式添加局部调试:


set -x
date
set +x

> bash script1.sh # 不需要添加调试参数
The script starts now.

+ date
Fri 28 Feb 2020 06:23:04 PM CST
+ set +x

This is a string: black
And this is a number: 9

调试参数表

短命令长命令效果
set -fset -o noglob对文件名停用元字符匹配
set -vset -o verbose打印输入的命令
set -xset -o xtrace命令行首打印+,执行出错会打印详细信息

调试用的参数可以在运行中动态叠加或删除:


> set -v
> date
date
Fri 28 Feb 2020 06:54:47 PM CST
> set -x      # 参数可以累加
date        # -v 的效果
+ date       # -x 的效果
Fri 28 Feb 2020 06:55:37 PM CST
> set +vx      # 取消参数
set +vx

通过使用-f选项可以显著减少脚本中的转义字符:


> ls ?
x86_64-pc-linux-gnu-library
> set -f      # 停用元字符匹配
> ls ?
ls: cannot access '?': No such file or directory
> touch ?
> ls ?
'?'
> rm ?
> set +f -x   # 选项 x 还可以用于显示详细错误信息
> aaa
+ aaa
+ '[' -x /usr/lib/command-not-found ']'
+ /usr/lib/command-not-found -- aaa

Command 'aaa' not found, did you mean:

command 'aha' from deb aha (0.5-1)
command 'jaaa' from deb jaaa (0.8.4-4)
command 'aa' from deb astronomical-almanac (5.6-6)

Try: sudo apt install <deb name>

+ return 127

默认调试

也可以直接在脚本第一行添加参数让脚本默认以调试模式启动:


#!/bin/bash -xv

还可以在可能出错的命令前用echo输出调试信息:


echo "debug message: now attempting to start w command"; w # 用 ; 对要执行的命令排序
echo "Variable VARNAME is now set to $VARNAME."

设置选项辅助调试

为了方便调试,我们可以使用set命令对bash的选项进行设置:


> set -o # 查看所有选项的开关状态
> set -o | grep xtrace
xtrace     off
> set -x # 等价于 set -o xtrace
> set -o | grep xtrace
+ grep --color=auto xtrace
+ set -o
xtrace     on
> set +x # 等价于 set +o xtrace
+ set +x
> set -o | grep xtrace
xtrace     off

常用调试选项

引用为定义变量时报错:


> unset $VAR;echo $VAR

> set -u # 等价于 set -o nounset
> echo $var
bash: var: unbound variable

为防止误操作覆盖文件中的数据, 设置禁止重定向到已经存在的文件:


> set -C # 等价于 set -o noclobber
> touch test
> date > test
bash: test: cannot overwrite existing file

设置不解析通配符:


> set -f # 等价于 set -o noglob
> touch *
> ll *
-rw-rw-r-- 1 remilia remilia 0 Mar 1 20:09 '*'

来源:https://segmentfault.com/a/1190000022163483

标签:bash,脚本调试
0
投稿

猜你喜欢

  • 苹果年底升级Boot Camp 支持Windows 7

    2009-10-23 08:14:00
  • 谷歌创始人布林:Android和Chrome将合二为一

    2009-11-22 09:28:00
  • 类Linux环境安装jdk1.8及环境变量配置详解

    2023-08-01 07:17:31
  • 最近流行的数据库挂马的解决方法

    2008-07-05 16:48:00
  • URL链接地址结构处理最好的SEO方式

    2008-07-10 13:16:00
  • WSUS服务器的详细配置和部署

    2009-12-02 18:48:00
  • 应用服务器的常见安全管理漏洞

    2009-05-28 11:08:00
  • 优酷在京发布优酷指数 艾瑞提供数据支持

    2009-11-13 11:23:00
  • 网站百度收录问题经验分享

    2007-08-16 13:19:00
  • 注意:SEO中可能被认定为垃圾网站的操作

    2008-12-23 10:08:00
  • 传谷歌或计划联手印度公司竞拍印度3G牌照

    2009-10-28 11:54:00
  • 从小切口看引擎对原创文章的抓取与排名

    2007-12-22 16:36:00
  • 新手谈怎样提高网站流量

    2008-03-07 16:07:00
  • 典型Web服务器入门

    2007-03-26 10:06:00
  • SSH命令详解

    2009-11-19 12:08:00
  • 服务器稳定性对于排名的影响

    2007-10-03 13:42:00
  • 站长们 为什么你的站没有流量

    2007-10-11 18:07:00
  • 15张Vim速查表-帮你提高N倍效率

    2021-12-10 14:07:27
  • 微软上下文广告展开内测 将单挑Google AdSense

    2008-07-19 12:05:00
  • 解并实现 IBM Lotus Notes 的本地邮件副本

    2010-01-04 19:03:00
  • asp之家 网站运营 m.aspxhome.com