美文网首页
C# 代码规范

C# 代码规范

作者: 百斧 | 来源:发表于2019-12-18 12:25 被阅读0次

代码规范

  1. 用Tab作为缩进,并设置缩进大小为4:


    缩进
  2. 换行,当一个表达式超过一行时,根据以下原则进行处理:
    • 在逗号后换行
    • 在操作符后换行
    • 在高层换行儿不是在低层换行
    • 折行后对其上一行语句同一层表达式的起始位置
  3. 类成员排列顺序
    • 字段
    • 属性
    • 事件
    • 构造函数
    • 方法
  4. If\else\else if\for\while\do等语句自占一行,左花括号必须占一行,并且在同一列,括号内容为空时可在一行
  5. 空行分隔不同逻辑程序块,是程序块布局更加清晰
  6. 尽量使类文件大小控制在300~400行,避免方法太长,尽量提出至更小的方法,使单个方法只完成一个任务

注释

  1. 类型、属性、事件、方法、方法参数,根据需要添加XML注释
  2. 如果类、属性、事件、方法、方法参数的名称已经自注释了,可不加注释
  3. 注释符与注释内容之间要用一个空格进行分隔
    • 正例
      /*
      注释内容
      */
      // 注释内容
    • 反例
      /注释内容/
      //注释内容
  4. 包含在{}中代码块的结束处应加注释,便于阅读。特别多分支,多重嵌套的条件语句和循环语句


    代码块注释

命名规则

  1. 类名与文件名保持一致
  2. 抽象类以Abstract为前缀或者以Base为后缀命名
  3. 异常类型以Exception为后缀
  4. 所有命名空间、类型名称使用Pascal风格
  5. 不使用缩写,所有类、字段、属性、方法、事件尽量不适用缩写,包括大家熟知的缩写, 如msg
  6. 方法名用大写字母开头的单词组合而成,且应当使用“动词”或者“动词+名词”动宾词组
  7. 不使用单个字母的变量,使用完整含义的词,不使用单个字母的变量,像i,m,n使用index等来替换,用于循环迭代的变量除外
  8. 本地变量、方法参数名使用Camel风格(不使用下划线)
  9. 类内部的私有变量和受保护字段,使用Camel分隔,加“_”前缀
  10. 常量名都要使用大写字母,用下划线‘_’分割单词,如MIN_VALUE。
  11. 静态字段或属性使用Pascal风格,首字母大写
  12. 接口命名在名字前加上“I”前缀,其他与类命名规则相同
  13. 委托和事件命名
    • 委托以EventHandler作为后缀命名,例如 SaleOutEventHandler
    • 事件以其对应的委托类型,去掉EventHandler,并加上On前缀构成,例如 OnSaleOut
  14. 返回bool类型的方法、属性命名
    • 方法以Is前缀,例如IsHidden
    • 属性以Can前缀, 例如CanHidden
  15. 程序中不要出现仅靠大小写区分的相似的标识符
  16. 用正确的反义词组命名具有互斥意义的变量或相反动作的函数等


    互斥
  17. 空间命名应采用完整的英文描述命名,名字的前缀是控件类型名缩写


    控件命名
  18. 常见集合后缀类型命名


    集合后缀类型

表达式及语句

  1. 在表达式中使用括号,使表达式的运算顺序更清晰


    表达式
  2. 不在for循环体内修改循环变量,防止for循环失去控制

其他

  1. 不能出现共有字段,共有字段必须以属性包装
  2. 不在代码中使用具体的路径和驱动器名,使用相对路径,并使其能复用
  3. 不要捕捉异常后什么也不做

相关文章

  • Rider配置团队共享的代码风格

    背景:目前团队使用的是Unity/C#开发,因此需要设置C#的代码规范1、C#代码风格配置路径:File | Se...

  • C# 代码规范

    代码规范 用Tab作为缩进,并设置缩进大小为4:缩进 换行,当一个表达式超过一行时,根据以下原则进行处理:在逗号后...

  • C#代码规范

    1.注释规范 类型、属性、委托、方法、方法参数,根据需要添加注释。如果类型、属性、委托、方法、方法参数的名称已经是...

  • .Net 开发规范

    .Net 开发规范一、C# 编码规范1. 代码组织与风格1.1. Tab要使一个Tab为4个空格长。1.2. 缩进...

  • C# 代码书写规范--备忘

    1、所有命名空间、类型名称使用Pascal风格,函数名采用 首字母大写驼峰式写法,例如 public class ...

  • python代码规范

    从C#转到了python,重新梳理一下代码规范。 一、四行缩进 1、注意子代码块; 2、注意括号中的换行; 二、空...

  • java与C#的AES加密、解密

    java代码: C#代码:

  • Unity Shader 切换贴图 (贴图渐变)

    c#代码

  • Web 端代码规范

    目录 1、代码规范概述 2、代码规范流程搭建 3、代码规范细则 1、代码规范概述 良好的代码规范能够提供软件的可读...

  • H5 SSE

    html C# 代码

网友评论

      本文标题:C# 代码规范

      本文链接:https://www.haomeiwen.com/subject/wqgynctx.html