Visual C_C++编程风格守则.docVIP

合肥泰纳公司 通用技术文档 Visual C/C++编程风格守则 二〇〇三年 十二月 八日 目 录 1. 匈牙利命名规则 3 2. 在开发实用系统中的命名约定 3 2.1 VC中变量命名的前缀约定 3 2.2 VC中变量命名的后缀约定 4 2.3 局部变量应尽量简洁易懂 4 2.4 函数命名也应该见名知意 4 2.5 禁止使用汉语拼音来命名 4 2.6在代码中尽量不用具体的大小数值，定义成宏，便于以后维护 4 2.7 VC中常用控件的缩写： 5 3．画面项目的ID命名规范 5 4. 编排 6 5. 程序开发环境规约 6 5.1 工作目录结构的规定: 6 5.2工程中不起作用的文件或类应删除，工程目录下的非工程文件也应该移走，保持工程的清洁，避免混淆难于管理 7 5.3在VC环境下，建议将常用的头文件全部放入stdafx.h中，而在每个cpp开始处嵌入stdafx.h。避免头文件的交叉引用，如果有严重的交叉引用，适当使用类的声明 7 5.4 将独立性比较强的模块抽出来，做成DLL，控件或COM组件，该模块可单独编写和测试，也增强了其可重用性 7 5.5 一个比较大的工程应留有一定的消息接口或插件接口等 7 5.6 工程的版本控制要严格，版本格式为xx.xx.xx，必要时使用Build次数或日期。高版本尽量兼容低版本的用法、数据或协议 7 5.7 工程的编译宏定义和工程参数设置应正确，每作一个新工程时应检查工程参数是否正确。建议字节对齐方式为1字节对齐 7 6. 程序备份 7 6.1 要有备份记录 7 6.2 定时备份 7 6.3 多种介质备份 7 6.4 在软盘上备份时，应该去掉中间文件和执行文件 7 7 VC程序界面设计规范 7 7.1颜色选择： 7 7.2字体的选择： 7 7.3图片的选择 8 7.4操作的便利性 8 7.5数据安全 8 7.6帮助文件 8 7.7窗体大小的确定 8 7.8视图的选择(单/多文档界面类型) 8 7.9 MFC应用程序类型的选择： 8 7.10 操作进度指示 9 7.11 分隔线控件 9 8. 其他 9 附录A 程序维护手册格式说明 9 附录B 部分编程常用单词缩写 12  Visual C/C++编程风格守则 1. 匈牙利命名规则 前缀 类型 备注 a Array b Boolean by Byte c Char 有符号型字符 cb Char Byte 无符号型字符（没多大用处） cr ColorRef 颜色参考值 cx,cy Length of x,y (ShortInt) 坐标差（长度） dw Double Word fn Function h Handle i Integer m_ Member of a class n Short Integer np Near Pointer p Pointer lp Long Pointer s String 不用str sz String with Zero End 以字符\0结尾的字符串 tm Text 文本内容 w Word x,y Coordinate 坐标 2. 在开发实用系统中的命名约定 2.1 VC中变量命名的前缀约定 变量类型 变量前缀 备注 Array a... 例：CStringArray saText BOOL b... UINT n... int i... short n... long l... WORD w... DWORD dw... float f... char c... char* psz... TCHAR* psz... LPCTSTR lpsz... CString s... COLORREF cr... LPLOGPALETTE lp... 包括LP开头的类型都是这样 POINT pt... CPoint pt... HANDLE h... HGLOBAL h... 包括H开头的类型都是这样 说明： 1．如果是指向上述类型的指针，就在上面规范前加 p； 2．如果是指向上述类型的双重指针，就在上面规范前加 pp； 3．如果是类成员变量，则在上面规范前加 m_； 4．全局变量,则在上面规范前加 g_； 5．在类型前加了const,命名约定不变。 2.2 VC中变量命名的后缀约定 MFC类 CWnd* p...Wnd 省去的地方一般为该类的用途 (如果是某一个类的成员，则还应该在前加 m_)又如：CView* p...View 2.3 局部变量应尽量简洁易懂使用常见的变量，如Num,nCount,i,j,k,n,len,pos, off