在大括号嵌套语法中, 最好是左右(先后) 大括号单独占一行, 这样的嵌套关系最清晰
也就是说, c/c++的风格是最清晰的. 而java php将 左大括号放在上一行的末尾, 稍次一点.
不过在if while switch等条件后, 紧跟大括号是经常使用的习惯, 并且 结尾大括号跟 这些关键词匹对 对齐也能表达出 正确的 嵌套逻辑php
长语句: 在换行时,咱们一般在一个变量或者常量以前换行,把逗号之类的分隔符、运算符留在前一行的行尾。(就是说, 把变量/常量放在下一行的
开头, 而不是将符合放在下一行的开头. 并且下一行 相对于变量/常量要缩进一次css
一样的, 函数调用时,若是参数个数不少,或者要传递的表达式写起来很长,那么也会涉及到长语句换行问题,
最基本的原则是:尽量地在参数与参数之间换行,并将逗号保留在上一行行末:java
// 这是一条很长的语句: 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
);c++
当传入的表达式较为复杂时,这种写法会显得格外地清晰。相似地,在同时声明多个同一类型的变量时,也能够如此书写:编程
double myvar1,
myval2,
myvar3,
myvar4;编程语言
它的主要目的是便于对单个变量进行注释:函数
char username[MAXN], // 用户名
password[MAXN], // 密码
desc[MAXN]; // 描述测试
这里提到的都是一些总结出来的比较常见的状况,它们并非金科玉律,只是一个建议,但倒是一个强烈的建议。ui
在遇到本文没有提到的状况时,能够根据实际状况和须要调整缩进。归根结底是为了更加清晰和正确地反映出代码的逻辑结构。3d
================================
目录结构规范
(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老是定位到 4的整数倍位置. 因此能够用它 来对齐代码.
插入空行能够增长代码的可读性,可是空行的多少没有明确的规定, 通常是根据代码的规模和风格而定, 通常: 代码量较少时使用一个空行,
代码量较多时, 使用2个/3个 空行进行分隔.
代码行太长时,要分行:
主要包括:
1. 多个条件 / 判断语句
2. 函数中多个参数的状况, 这个在msdn中是最常常遇到的: