Unity之命名规范(二)

书接上回Unity 之命名规范(一)下面笔者说一些是示例和使用规范。在你自己的项目中可以使用这些或者根据自己的需要进行调整。


有错误或者不准确的地方欢迎留言指正



使用 PascalCasing 的类名称和方法名称

原因:与Microsoft的.NET Framework一致并且易于阅读

public class ClientActivity
{
    public void ClearStatistics()
    {
        //...
    }
    public void CalculateStatistics()
    {
        //...
    }
}

使用camelCasing的方法参数和局部变量

原因:与Microsoft的.NET Framework一致并且易于阅读

public class UserLog
{
    public void Add(LogEvent logEvent)
    {
        int itemCount = logEvent.Items.Count;
        // ...
    }
}

不要在标识符中使用Hungarian 符号或者任何其他类型标识

原因:与Microsoft的.NET Framework和Visual Studio IDE一致,使得确定类型变得非常简单(通过工具提示)。一般来说,你应该避免任何标识符中的类型指示符。

// 正确写法
int counter;
string name;
 
// 错误写法
int iCounter;
string strName;

不要将Screaming Caps(这个我也不知道怎么翻译,大概的意思是全部大写)用于常量或只读变量

原因: 与微软的.NET Framework一致。Screaming Caps过于密集不方便阅读

// 正确
public static const string ShippingType = "DropShip";
 
// 错误
public static const string SHIPPINGTYPE = "DropShip";

避免使用缩写。一般用到缩写的地方如:Id, Xml, Ftp, URL(这个确实重要,例如:BT,在这项目中我怎么理解?!变态?按钮?Big Tag? WTF!!!)

原因: 与Microsoft的.NET Framework保持一致并防止缩写不一致。

// 正确
UserGroup userGroup;
Assignment employeeAssignment;
 
// 错误
UserGroup usrGrp;
Assignment empAssignment;
 
// 例外
CustomerId customerId;
XmlDocument xmlDocument;
FtpHelper ftpHelper;
UriPart uriPart;

使用PascalCasing缩写3个或更多字符(2个字符都是大写)

原因: 与微软的.NET Framework一致。全部大写在视觉上过度关注

HtmlHelper htmlHelper;
FtpTransfer ftpTransfer;
UIControl uiControl;

不要在标识符中使用下划线

原因: 与微软的.NET Framework一致,使代码更加自然地阅读

// 正确
public DateTime clientAppointment;
public TimeSpan timeLeft;
 
// 错误
public DateTime client_Appointment;
public TimeSpan time_Left;

使用 predefined type names 而不是系统类型名称,如Int16, UInt64等

原因: 与Microsoft的.NET Framework一致,使代码更加自然。

// 正确
string firstName;
int lastIndex;
bool isSaved;
 
// 错误
String firstName;
Int32 lastIndex;
Boolean isSaved;

使用隐式VAR局部变量声明。例外:原始类型(int,string,double等)使用预定义的名称。(不过笔者不建议这么弄,看上去表达不清晰,当然单从观赏性来讲Var是个不错的选择)

原因:消除混乱,特别是复杂的泛型类型。使用Visual Studio工具提示可轻松检测类型。

var stream = File.Create(path);
var customers = new Dictionary();
 
// Exceptions
int index = 100;
string timeSheet;
bool isCompleted;

使用名词或名词短语来命名一个类

原因:与Microsoft的.NET Framework一致并且易于记忆。

public class Employee
{
}
public class BusinessLocation
{
}
public class DocumentCollection
{
}

用字母I 做接口的前缀(你要是不写I编辑器都会提醒你 )。接口名称是名词(短语)或形容词。

原因:与微软的.NET Framework一致。

public interface IShape
{
}
public interface IShapeCollection
{
}
public interface IGroupable
{
}

根据他们的主要类来命名源文件。例外:具有部分类的文件名反映它们的来源或目的,例如designer, generated等。(换句话说就是有嵌套类的时候命名按照他们父类的名称来,例外说的就是见名知意,尽量减少让阅读者看到这个类猜这个类是干什么的~)

原因:符合微软的做法。文件按字母顺序排列,部分类保持相邻。

// Located in Task.cs
public partial class Task
{
    //...
}
// Located in Task.generated.cs
public partial class Task
{
    //...
}

用一个清晰定义的结构来组织命名空间(就是说要分类划分,就像动画系统里面的命名功能不能写到UI系统里面一样)

原因:与微软的.NET Framework一致。保持良好的代码库组织.

// Examples
namespace Company.Product.Module.SubModule
namespace Product.Module.Component
namespace Product.Layer.Module.Group

垂直对齐大括号。

class Program
{
    static void Main(string[] args)
    {
    }
}

在类的顶部声明所有成员变量,用在最高层的静态变量。

原因: 普遍接受的做法,防止需要寻找变量声明。

public class Account
{
    public static string BankName;
    public static decimal Reserves;
 
    public string Number {get; set;}
    public DateTime DateOpened {get; set;}
    public DateTime DateClosed {get; set;}
    public decimal Balance {get; set;}
 
    // Constructor
    public Account()
    {
        // ...
    }
}

使用单数名字枚举。例外:位字段枚举。

原因:与Microsoft的.NET Framework一致,使代码更加自然阅读。多个标志,因为枚举可以保存多个值(使用按位、或)。(这个笔记不是很清楚什么意思)

// Correct
public enum Color
{
    Red,
    Green,
    Blue,
    Yellow,
    Magenta,
    Cyan
}
 
// Exception
[Flags]
public enum Dockings
{
    None = 0,
    Top = 1, 
    Right = 2, 
    Bottom = 4,
    Left = 8
}

明确指定枚举的类型或枚举的值(除了位域)

原因:在依赖实际类型和值时会造成混淆

// 错误
public enum Direction : long
{
    North = 1,
    East = 2,
    South = 3,
    West = 4
}
 
// 正确
public enum Direction
{
    North,
    East,
    South,
    West
}

不要在枚举名称后缀再次添Enum

原因:与Microsoft的.NET Framework保持一致,与在标识符中没有类型指标的规则一致。(但是在unity中一般在Button的变量字段后缀都添加Button,例如Button openButton = null;)

// 错误
public enum CoinEnum
{
    Penny,
    Nickel,
    Dime,
    Quarter,
    Dollar
}
 
// 正确
public enum Coin
{
    Penny,
    Nickel,
    Dime,
    Quarter,
    Dollar
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,100评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,308评论 3 388
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,718评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,275评论 1 287
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,376评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,454评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,464评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,248评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,686评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,974评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,150评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,817评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,484评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,140评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,374评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,012评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,041评论 2 351

推荐阅读更多精彩内容