什么时候使用tab键来对齐代码和代码的风格

时间:2021-05-15 17:42:41
  1. 在大括号嵌套语法中, 最好是左右(前后) 大括号单独占一行, 这样的嵌套关系最清晰

    也就是说, c/c++的风格是最清晰的. 而java php将 左大括号放在上一行的末尾, 稍次一点.

    不过在if while switch等条件后, 紧跟大括号是常用的习惯, 而且 结尾大括号跟 这些关键词匹对 对齐也能表达出 正确的 嵌套逻辑

  2. 长语句: 在换行时,我们通常在一个变量或者常量之前换行,把逗号之类的分隔符、运算符留在前一行的行尾。(就是说, 把变量/常量放在下一行的

    开头, 而不是将符合放在下一行的开头. 而且下一行 相对于变量/常量要缩进一次

    同样的, 函数调用时,如果参数个数很多,或者要传递的表达式写起来很长,那么也会涉及到长语句换行问题,

    最基本的原则是:尽可能地在参数与参数之间换行,并将逗号保留在上一行行末:

// 这是一条很长的语句:
myvar = myvar1 + myvar2 + myvar3 - myvar4 - myvar5 * myvar6 * myvar7 /
myvar8 / myvar9 + myvar10 + myvar11 - myvar12 – myvar13 * myvar14 *
myvar15 / myvar16;
// 后面的语句恢复正常的缩进位置 // 在参数与参数之间换行
printf("This function call has many parameters. %d %d %d %d/n", myvar1,
myvar2, myvar3, myvar4);

在一些必要的情况下,我们为了清晰地列个出函数的每一参数,可以采取类似结构 类 声明的写法:

// 每个参数分行

printf(

"This function call has many parameters. %d %d %d %d/n",

myvar1,

myvar2,

myvar3,

myvar4

);

当传入的表达式较为复杂时,这种写法会显得格外地清晰。类似地,在同时声明多个同一类型的变量时,也可以如此书写:

double myvar1,

myval2,

myvar3,

myvar4;

它的主要目的是便于对单个变量进行注释:

char username[MAXN], // 用户名

password[MAXN], // 密码

desc[MAXN]; // 描述

总之, 一点, 就是, 现代的编程语言, 对空格, tab, 回车等都可以随意的使用! 于是 你可以为了使 变量, 函数等等 任意代码(不像dos bat等编程

对空格还有严格要求) 处于: "清晰" "易读" "明了" "优美" 整齐等的目的 可以使用 "空格, tab, 回车" 等手段 做任意的调整, 移动!!

你可以给自己规定一套 一贯的 习惯性的 长期使用的 "书写规则" , 如: 如单词之间, 除了小括号/中括号/逗号分号等标点符号跟左右单词紧挨着

之外, 其他单词之间包括加减乘除等运算符合/大括号 之间都相隔一个空格!

这里提到的都是一些总结出来的比较常见的情况,它们并不是金科玉律,只是一个建议,但却是一个强烈的建议。

在遇到本文没有提到的情况时,可以根据实际情况和需要调整缩进。归根结底是为了更加清晰和正确地反映出代码的逻辑结构。

================================

目录结构规范 

(1) 目录建立的原则:以最少的层次提供最清晰简便的访问结构。

(2) 目录的命名以小写英文字母,下划线组成。(参照命名规范)。 

(3) 根目录一般只存放index.htm以及其他必须的系统文件;每个主要栏目开设一个相应的独立目录;

**(为什么说根目录下有img/css/js等目录, 而子目录中也有这样的目录呢?)

    因为:  根目录下的images/css/js等目录 用于存放各页面都要使用的公用图片,子目录下的  images目录存放本栏目页面使用的私有图片!!!

(4) 所有JS,ASP,PHP等脚本存放在根目录下的scripts目录。

(5) 所有CGI程序存放在根目录下的cgi-bin目录。 (6) 所有CSS文件存放在根目录下style目录。 

(7) 每个语言版本存放于独立的目录。例如:简体中文gb; 

(8) 所有flash, avi, ram, quicktime 等多媒体文件存放在根目录下的media目录。

文件头部的声明

顶部声明内容 

文件的顶部可以包含文件的测试数据、注释、作者、创建时间、修改人、修改时间。但不强行规定。

但涉及到数据的,需要包含测试数据。注释以//的方式添加多个单行注释。

什么时候 使用tab键?

tab的作用: 是用它来对齐代码的!
因此:
凡是你想对齐代码的时候, 你需要对齐代码的时候, 想对齐对齐代码的地方 , 都可以 都应该使用tab tab的特性是: 当按tab键的时候, 光标总是定位到下一tab位, 而不管这个之间有多少内容. 也就是说, tab总是定位到 4的整数倍位置. 所以可以用它
来对齐代码.

插入空行?

插入空行可以增加代码的可读性,但是空行的多少没有明确的规定, 一般是根据代码的规模和风格而定, 一般: 代码量较少时使用一个空行,

代码量较多时, 使用2个/3个 空行进行分隔.

代码分行?

代码行太长时,要分行:

主要包括:

1. 多个条件 / 判断语句

2. 函数中多个参数的情况, 这个在msdn中是最经常遇到的:

什么时候使用tab键来对齐代码和代码的风格

什么时候使用tab键来对齐代码和代码的风格

什么时候使用tab键来对齐代码和代码的风格

什么时候使用tab键来对齐代码和代码的风格