有了这个神器,再也不怕shell写得不对了

系统 Linux
shellcheck就是这样的一个工具。它可以在多种场景下使用,包括在线,命令行检查,编辑器配置,下面逐一介绍。

写过shell脚本的人都知道,即便出现一些简单的语法错误,运行的时候也可能没有办法发现。有些看似运行正确的脚本,实际上可能在某些分支,某些场景下仍然出现错误,而有的写法可能运行正常,但是却不符合POSIX标准,不具备可移植性。

诚然,shell脚本是解释运行,没有办法向C/C++那样严格检查,但是我们仍然可以借助一些工具帮助我们提前发现一些错误。

shellcheck

shellcheck就是这样的一个工具。它可以在多种场景下使用,包括在线,命令行检查,编辑器配置,下面逐一介绍。

在线使用

顾名思义,它提供了一个在线的检查地址,https://www.shellcheck.net/,进入网址即可使用。

例如,你输入你的脚本内容: 

  1. #!/bin/sh  
  2. for n in {1..$RANDOM}  
  3. do  
  4.   str=""  
  5.   if (( n % 3 == 0 ))  
  6.   then  
  7.     str="fizz"  
  8.   fi  
  9.   if [ $[n%5] == 0 ]  
  10.   then  
  11.     str="$strbuzz"  
  12.   fi  
  13.   if [[ ! $str ]]  
  14.   then  
  15.     str="$n"  
  16.   fi  
  17.   echo "$str"  
  18. done 

shell

它会给出错误提示或者建议: 

  1. Line 2:  
  2. for n in {1..$RANDOM}  
  3.          ^-- SC2039: In POSIX sh, brace expansion is undefined.  
  4.              ^-- SC2039: In POSIX sh, RANDOM is undefined.  
  5. Line 5:  
  6.   if (( n % 3 == 0 ))  
  7.      ^-- SC2039: In POSIX sh, standalone ((..)) is undefined.  
  8. Line 9:  
  9.   if [ $[n%5] == 0 ]  
  10.        ^-- SC2039: In POSIX sh, $[..] in place of $((..)) is undefined.  
  11.        ^-- SC2007: Use $((..)) instead of deprecated $[..]  
  12.               ^-- SC2039: In POSIX sh, == in place of = is undefined.  
  13. Line 11:  
  14.     str="$strbuzz"  
  15.          ^-- SC2154: strbuzz is referenced but not assigned.  
  16. Line 13:  
  17.   if [[ ! $str ]]  
  18.      ^-- SC2039: In POSIX sh, [[ ]] is undefined. 

怎么样,是不是很给力,每个可能的错误都提示了。新手写shell出现莫名的报错时,可以尝试使用奥。当然例子中很多并不是真的错误,而是某种写法不符合POSIX标准,这种情况也应该避免。

关于shell的基本内容,也可以参考《shell必备基础知识》。

命令行使用

命令行安装也很简单(记得使用root权限),ubuntu下: 

  1. $ apt-get install shellcheck 

centos下: 

  1. $ yum -y install epel-release 

Fedora下: 

  1. $ dnf install ShellCheck 

使用方法也很简单了: 

  1. $ shellcheck myscript.sh 

举个例子,下面的写法是新手最容易出错的地方之一: 

  1. //来源:公众号【编程珠玑】  
  2. //作者:守望先生  
  3. #!/bin/bash  
  4. if[ $# -eq 0 ]  
  5. then  
  6.     echo "no para"  
  7. else  
  8.     echo "$# para"  
  9. fi  
  10. exit 0 

看运行报错: 

  1. ./test.sh: line 4: if[ 0 -eq 0 ]: command not found  
  2. ./test.sh: line 5: syntax error near unexpected token `then'  
  3. ./test.sh: line 5: `then' 

只是告诉你在then附近有语法问题,到底什么问题呢?我们用shellcheck看看: 

  1. $ shellcheck test.sh  
  2. In test.sh line 4:  
  3. if[ $# -eq 0 ]  
  4.   ^-- SC1069: You need a space before the [. 

这么一看,就很清楚了,原来[前面少了空格。

编辑器中使用

当然也可以把它安装到你熟悉的编辑器中,虽然它们本身都有语法高亮的功能,但是并没有直接的信息提示,安装shellcheck类工具,达到编写即提示的效果。

  •  Emacs, 可以使用 Flycheck.
  •  Sublime,可以使用 SublimeLinter.
  •  Atom,可以使用 Linter.
  •  vim ,可以使用ale或者syntastic

当然了,现代很多IDE都有这样检查功能,这里只说编辑器。

这里以syntastic为例,实际上它支持多种语言的语法检查。

安装过程:

1.安装pathogen.vim 

  1. $ mkdir -p ~/.vim/autoload ~/.vim/bundle && \  
  2. curl -LSso ~/.vim/autoload/pathogen.vim https://tpo.pe/pathogen.vim 

并且在vimrc文件中配置以下内容: 

  1. execute pathogen#infect() 

2.安装 Install syntastic 

  1. cd ~/.vim/bundle && \  
  2. git clone --depth=1 https://github.com/vim-syntastic/syntastic.git 

3.测试安装情况

打开vim,输入以下内容 

  1. :Helptags 

如果没有报错,说明安装正常。

在vimrc中配置以下内容: 

  1. set statusline+=%#warningmsg#  
  2. set statusline+=%{SyntasticStatuslineFlag()}  
  3. set statusline+=%*  
  4. let g:syntastic_always_populate_loc_list = 1  
  5. let g:syntastic_auto_loc_list = 1  
  6. let g:syntastic_check_on_open = 1 

常用: 

  1. :Errors 显示错误面板  
  2. :lnext  到下一个错误  
  3. :lprevious 到上一个错误 

更多安装详情也可以参考https://github.com/vim-syntastic/syntastic

以上是官网推荐的安装方式,也可以在安装了Vundle(这是一种老旧的插件管理方式,你可以尝试vim-plug等其他插件管理工具)的前提下,通过在配置文件中加入: 

  1. Plugin 'scrooloose/syntastic' 

打开vim输入: 

  1. :PluginInstall 

即可安装。

,具体安装方式可以参考《vim完整开发环境配置--老旧版》。

使用效果:

shell检查:

C语言语法检查:

实际上它可以支持几乎所有常见编程语言的语法检查。

具体可以查看这里

https://github.com/vim-syntastic/syntastic/blob/master/doc/syntastic-checkers.txt

不知道vimrc文件在哪里?

打开vim,输入: 

  1. :version 

就可以看到啦:   

  1. system vimrc file: "$VIM/vimrc"  
  2.      user vimrc file: "$HOME/.vimrc"  
  3.  2nd user vimrc file: "~/.vim/vimrc"  
  4.       user exrc file: "$HOME/.exrc"  
  5.   system gvimrc file: "$VIM/gvimrc"  
  6.     user gvimrc file: "$HOME/.gvimrc"  
  7. 2nd user gvimrc file: "~/.vim/gvimrc"  
  8.     system menu file: "$VIMRUNTIME/menu.vim" 

它们区别在于生效范围不一样,对于用户的vimrc,自然只是对特定用户生效。

总结

工欲善其事必先利其器,有好的工具,自然就该用起来。欢迎分享更多的方法或工具。 

 

责任编辑:庞桂玉 来源: Linux学习
相关推荐

2021-03-19 09:55:15

Linuxshell命令

2021-08-12 11:05:07

C++语言内存泄露

2021-03-26 15:18:11

代码工具Mockoon

2022-04-14 10:22:30

NginxLinux

2022-09-20 14:30:24

脚本工具SQL数据库

2020-04-20 15:00:22

DevOps工具代码

2020-05-07 09:05:22

电脑Python代码

2021-05-08 07:53:33

面试线程池系统

2019-12-26 09:38:57

GitHub工具 wxpy

2024-06-20 12:51:37

PythonTermcolor

2014-07-18 15:54:04

goTenna:随身无

2023-07-29 22:02:06

MyBatis数据库配置

2020-01-21 21:15:16

WiFi网络WiFi6

2020-07-14 20:03:55

Windows 10Windows微软

2019-08-19 14:59:49

GitHub代码开发者

2018-05-18 14:39:46

华为 华为云

2022-06-01 10:09:39

Linux网络延迟

2020-09-16 06:08:10

Linux文本比对代码

2021-11-10 23:26:27

iPhone手机屏幕

2021-08-02 10:14:52

AI数据人工智能
点赞
收藏

51CTO技术栈公众号