目录
1 概览 1
1.1 原则和主旨 1
1.2 术语 2
2 通用编程规范 3
2.1 明确和一致 3
2.2 格式和风格 3
2.3 库的使用 5
2.4 全局变量 5
2.5 变量的声明和初始化 6
2.6 函数的声明和调用 7
2.7 语句 8
2.8 枚举 9
2.9 空格 14
2.10 大括号 15
2.11 注释 17
2.12 代码块 26
3 C++ 编程规范 27
3.1 编译器选项 27
3.2 文件和结构 29
3.3 命名规范 30
3.4 指针 34
3.5 常量 34
3.6 类型转换 35
3.7 Sizeof 36
3.8 字符串 37
3.9 数组 38
3.10 宏 39
3.11 函数 40
3.12 结构体 43
3.13 类 44
3.14 COM 50
3.15 动态分配 51
3.16 错误和异常 52
3.17 资源清理 55
3.18 控制流 58
4 .NET 编码规范 61
4.1 类库开发设计规范 61
4.2 文件和结构 61
4.3 程序集属性 61
4.4 命名规范 61
4.5 常量 65
4.6 字符串 65
4.7 数组和集合 67
4.8 结构体 69
4.9 类 70
4.10 命名空间 74
4.11 错误和异常 74
4.12 资源清理 77
4.13 交互操作 90
1 概览
本文档为一站式示例代码库项目组所使用的C++ 以及 .NET 编码规范 。该规范源自于产品开发过程中的经验,并在不断完善。如果您发现一些最佳实践或者话题并没有涵盖在本文档中,请联系我们一站式示例代码库项目组 ,以不断充实完善本文档。
任何指导准则都可能会众口难调。本规范的目的在于帮助社区开发者提高开发效率,减少代码中可能出现的bug,并增强代码的可维护性。万事开头难,采纳一个不熟悉的规范可能在初期会有一些棘手和困扰,但是这些不适应很快便会消失,它所带来的好处和优势很快便会显现,特别是在当您接手他人代码时。
1.1 原则和主旨
高质量的代码示例往往具有如下特质:
1. 易懂 – 代码示例必须易读且简单明确。它们必须能展示出重点所在。示例代码的相关部分应当易于重用。示例代码不可包含多余代码。它们必须带有相应文档说明。
2. 正确性 – 示例代码必须正确展示出其欲告知使用者的重点。代码必须经过测试,且可以按照文档描述进行编译和运行。
3. 一致性 – 示例代码应该按照一致的编程风格和设计来保证代码易读。 同样的,不同代码示例之间也应当保持一致的风格和设计,使使用者能够很轻松的结合使用它们。一致性将我们一站式示例代码库优良的品质形象传递给使用者,展示出我们对于细节的追求。
4. 流行性 – 代码示例应当展示现行的编程实践,例如使用 Unicode,错误处理,防御式编程以及可移植性。示例代码应当使用当前推荐的运行时库和API函数,以及推荐的项目和生成设置。
5. 可靠性 – 代码示例必须符合法律,隐私和政策标准和规范。不允许展示入侵性或低质的编程实践,不允许永久改变机器状态。所有的安装
微软编程之规范_IT/计算机_专业资料。微软编程之规范ZD项目编程 编程规范 ZD-Library 项目编程规范 第一章 概述... 3 术语定义 ......
微软官方编程规范约定_IT/计算机_专业资料。很权威的命名规范约定,解决你在编写代码是遇到的大小写问题,相信对你受益匪浅,希望广泛传播,以便大家有统一标准……谢谢...
微软编码规范检查工具 StyleCop 介绍 微软编码规范检查工具 StyleCop 介绍 一.功能...SourceAnalysis(StyleCop)是代码级别的,更适合于程序员在编程过程中使用. Source...
微软编程规范 41页 1下载券 2014微软暑期实习生机试... 暂无评价 2页 1...微软笔试真题两套 zz 微软笔试真题一: 微软笔试 1.简要谈一下您对微软.NET ...
科技的实力、创新的活力、服务的诚信力 编程规范的介绍 An Introduction to C ...“写好代码的10个秘诀”-微软,林斌) 4 主要内容 1.命名规范 2.代码风格与...
编程规范 目前请先熟记并严格遵守带有 格式的条例。 1 1.1 1.2 1.3 1.4...此命名法就是 通过微软的各种产品和文档传出来的。 多数有经验的程序员, 不管...
微软编码规范检查工具StyleCop_介绍_计算机软件及应用_IT/计算机_专业资料。微软...SourceAnalysis(StyleCop)是代码级别的,更适合于程序员在编程过程中使用。 Source...
Windows编程规范_计算机软件及应用_IT/计算机_专业资料。Visual Studio 是目前最...微软引进建立在.NET 框架(版本 1.0)的托管代码机 制以及一门新的语言 C# ...
VC编程规范_信息与通信_工程科技_专业资料。VC 编程 规范代码规范 关于代码...VC中有自动整理格式功能 – 只要选取需要的代码,按ALT+F8就能自动整理成微软的...
可以参考微软的命名方式 例如: cbOk cbExt 其命名方式是将分为两部分,前缀部分...编程规范 密级:保密 CVariable m 定义变量的命令:Public ,Private ,Dim ,Const...
热门文档