编写高质量代码改善C#程序的157个建议——建议142:总是提供有意义的命名
2024-08-27 10:48:51
建议142:总是提供有意义的命名
除非有特殊原型,否则永远不要为自己的代码提供无意义的命名。
害怕需要过长的命名才能提供足够的意义?不要怕,其实我们更介意的是在代码的时候出现一个iTemp。
int i 这样的命名只能出现在循环中(如for循环),除此之外,我们找不到任何理由在代码的其他地方出现这样的无意义命名。
例如,以下命名都是良好的典范:
private CultureInfo m_CurrentCulture;
private CultureInfo m_CurrentUICulture;
private int m_ManagedThreadId;
private string m_Name;
private int m_Priority; public static int GetDomainID()
{
return GetDomain().GetId();
} public override int GetHashCode()
{
return this.m_ManagedThreadId;
} private extern bool JoinInternal(int millisecondsTimeout);
我们可以看到每一个命名都表达了本身具有的含义。良好的命名带来的一个显而易见好处是,我们甚至可以减少大部分的代码注释。
糟糕的命名如下:
int theID; int GetID(int a, int b)
{
int iTemp;
//省略
return iTemp;
}
这个反例,字段变量theID指示不明,阅读者看到这样的命名根本不知道开发者所表达的意思。方法GetID的参数a和b也是指示不明的,调用者根本不知道应该传入什么值。内部的ITemp同样糟糕,时间一长,即便开发者本人也会忘记当初所设定的这个变量的含义。
转自:《编写高质量代码改善C#程序的157个建议》陆敏技
最新文章
- WinForm TreeView递归加载
- 第二篇T语言实例开发(版本5.3),福彩3D摇号器
- [SLAM] 01 ";Simultaneous Localization and Mapping"; basic knowledge
- virtualbox 不能为虚拟电脑打开一个新任务/VT-x features locked or unavailable in MSR.
- @version ||= version
- BZOJ2905 : 背单词
- HDU 1075 What Are You Talking About(Trie的应用)
- JEvaluator Jscript.net
- 利用LibreOffice转换ppt、doc转化pdf
- 执行gem install dryrun错误
- mac下brew install 报错
- 离线安装 Cloudera Manager 5 和 CDH5.10
- .net 添加api不能访问的问题
- 对话框--pop&;dialog总结
- 快速学习 javascript
- C#字符串、字节数组和内存流间的相互转换
- DMA/Zero copy
- 【BZOJ 4819】 4819: [Sdoi2017]新生舞会 (0-1分数规划、二分+KM)
- TensorFlow支持GPU配置问题
- Kibana6.3.1安装