码迷,mamicode.com
首页 > 其他好文 > 详细

脚本规范与优秀的开发习惯

时间:2016-06-17 17:39:05      阅读:155      评论:0      收藏:0      [点我收藏+]

标签:shell脚本规范   shell优秀的开发习惯   

 <--目录-->

 1)脚本模块名

 2)代码框架

 3)函数规范

 4)脚本存放规范

 5)补充规范19条

 6)优秀的开发习惯

 

【脚本模块名】

  1、常规Shell脚本使用统一后辍:.sh,例:wsyht.sh

  2、模块的启动和停止脚本统一命名为start_{模块名}.sh和sop_{模块名}.sh

  3、监控脚本可以*_mon.sh为后辍,控制脚本以*_ctl.sh为后辍

  4、模块(及其脚本和二进制程序)命名应该代表其特性和功能,不要使用个人名字缩写等形式命名

  5、模块中的脚本和二进制程序命名禁止和其它脚本和二进制程序重名



【代码框架】

  1、脚本开头解释器声明为 #!/bin/bash,也可以为#!/bin/sh,尽量统一

  2、配置文件及库函数脚本等的引用如,source conf/httpd.conf

  3、主脚本过程只实现程序主干,功能实现尽量封装在子函中

  4、对于能独立执行的脚本要有 usage 和 version 函数,可以输出脚本用法和版本信息

  5、规范代码树如下:

  [root@localhost ~]# tree

  |-- bin

  |   `-- ipsecct

  |-- conf

  |   `-- ipsec.cfg

  `-- func

      `-- functions



【函数规范】

  1、函数定义时在函数名前加上function保留字,虽然/etc/init.d/functions中没有这样做

  2、尽量一行一条语句,而不是使用":"将多个语句隔开,尽可能多的判断操作是否成功,并对其进行相应处理

  3、对于重要的函数,需说明函数用途,参数,返回值,作者,版本


  

【脚本存放规范】

  1、服务控制脚本统一放置在/service/scripts目录下;如果多个运维人员,可以放在以自已用户命名的二级目录下,如/server/scrips/username;比如我开发的脚本可以放在/server/scripts/wsyht下



【补充规范19条】

  1、必须要有基本的日志输出

  2、要关注脚本的效率和系统消耗,综合、平衡的考虑

  3、函数参数传递:在调用函数时,向函数传递的参数如果是以变量的方式进行传递,必须使用双引号将变量引起,这是为了防止某个变量中以多个空格分隔的字段,导致函数误认为是多个参数

  4、避免cat大文件。比如for id in `cat id_file`;do … ;done。而是采用readline形试读入文件

  5、对上一个命令需要if [ $? ]来判断返回值,对于异常分支,需有相应的处理策略;或打印warning日志,或提示后退出

  6、sort超过1G数据文件时,必须用-T指定临时文件夹,推荐在使用到sort的时候就使用-T指定到自身的TMP目录

  7、避免使用大的while/for循环,如果实在需要,请考虑用awk命令替代

  8、对于一系列有严格依赖关系的命令,请使用&&来处理,比如:make mydir && mv myfile mydir; 对于有前后次序的脚本,禁止采用后台运行 & 命令。(推荐)

  9、脚本运行前后,注意清除过期数据(上次运行生成的数据),注意rm的风险,可考虑替代方法,如find

  10、对于功能较为复杂的脚本,考虑使用一些函数对功能点进行封装。这样可以使脚本清晰易读。(推荐)

  11、任何出错情况必须将出错信息打印到日志中;严重的错误必须以邮件或短信报警的形式发出。(必须)

  12、对于逻辑比较复杂的脚本,可以使用 set -x 来打印命令执行情况,便于调式和排错(推荐)。

  13、wget之前,注意先删除本地文件;(推荐)

  14、拷贝比较大的文件时,最好先将文件cp到一个临时文件夹,然后mv到目标文件夹,避免下游模块读取到了不完整文件

  15、mv,cp模块,注意要使用命令全路径,直接强制替换,如/bin/cp -ap wsyht /tmp

  16、脚本中,要注意对单引号‘‘ 双引号"" 的转义,不明确转义启义的,在自测的时候多加小心。(推荐)

  17、例用ps axuw|grep 来获取信息时,注意ps打印的最大宽度。建议多打几个w

      例如ps auxwww|grep … ;(推荐)

  18、使用sort,uniq,join,comm等命令时,要注意两点:

      1、是否要求排序(例如uniq,join,comm要求输入文件是排好序的);

      2、如果排序,要求以什么方式排序(例如,comm要求输入文件是排好序的,而不是数值序);(推荐)

  19、对于Java程序脚本等需要环境变量的,在写脚本前,最好通过export重新声明环境变量,以免在定时任务场合使用出现问题



【优秀的开发习惯】

  1、尽量少用中文注释:如果非要用,要根据自身的客户端对服务器进行字符集调整-

     如:export LANG="zh_CN.GB18030"在脚本中,调整下了符集

  2、尽量以.sh为扩展名

     例:script-name.sh

  3、书写代码习惯:

     a.成对内容的一次写出来。如:

       {}、[]、‘‘、``、""

     b.流程控制语然一次书写完,如:

       if语句格式一次完成:

     c: 书写[]时,添内容之前直接两端的空格留出来,例: [ content ]

     d.变量的字符串定义加双引号,等号前后不能有空格。WSYHT_FILE="test.txt"

     f.变量的引用加双引号,大括号,"{WSYHT_FILE}"

     g.特别注意,脚本中的单引号

  4、调整vim语法配置,及内容自动补便配置


本文出自 “wsyht的博客” 博客,请务必保留此出处http://wsyht2015.blog.51cto.com/9014030/1790227

脚本规范与优秀的开发习惯

标签:shell脚本规范   shell优秀的开发习惯   

原文地址:http://wsyht2015.blog.51cto.com/9014030/1790227

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!