C++语言程序设计代码规范
1 命名规范
本规范对变量、函数、类（结构）等的名称有严格的规定，在编码过程中务必遵守。
1.1 变量命名规范
变量名称采用匈牙利命名法，即：完整的名称由“缀”和“主体”复合而成。“缀”用于指示变量的种类、数值类型、作用域等属性，由小写字符和下划线（_）组成，根据其附着在“主体”的位置分为前缀和后缀两种。“主体”表示变量的语义。
整个变量名称的格式如下：
<作用域前缀>[<指针缀>]<类型缀><主体><作用域后缀>
下面详细论述。
1.1.1 作用域缀（前缀和后缀）
作用域前缀处在整个变量名的最前面。常用的作用域前缀为：
作用域后缀处在整个变量名的最后面。只有一种情况使用作用域后缀，就是函数的形参必须以作用域后缀结束。
1.1.2 指针缀
如果一个变量是指针，则必须使用指针缀。指针缀使用字母p表示。
以前，在DOS平台下有短指针和长指针的区别，有时称长指针为lp。在Win32平台下已经不存在这个区别了，所以统一使用p, 而不是lp。
1.1.3 类型缀
类型缀由小写字符构成，用于描述变量的类型。注意：
1.不要私自创造出各种各样的前缀。
2.也没有必要在前缀中仔细区分一些细小的类型区别，那样会给代码维护工作带来额外的麻烦。
常用的类型前缀为：
对于其他不在上面表中的结构、类等复杂数据类型，特别是不常使用的和不通用的，不使用前缀。例如：
class Person Jonson;
struct DateTime MyDt;
在应用场合明确的情况下，例如：简单的局部变量，它的值类型前缀有时可以省略。具体见下面的例子。
1.1.4 复合前缀
根据以上规则，变量根据它所在的作用域、类型、是否是指针，得到一个复合前缀。例如：
char g_szFileName[_MAX_PATH]; //全局字符串变量
char* g_pszFileName; //全局字符串指针变量：
char s_szFileName[_MAX_PATH]; //静态字符串变量
char* s_pszFileName; //静态字符串指针变量：
char _s_szFileName[_MAX_PATH]; //局部静态字符串变量
char* _s_pszFileName; //局部静态字符串指针变量：
char m_szFileName[_MAX_PATH]; //类字符串变量
char* m_pszFileName; //类字符串指针变量：
char ms_szFileName[_MAX_PATH]; //类静态字符串变量
char* ms_pszFileName; //类静态字符串指针变量：
更多的例子，参见下面按照作用域讨论变量名一节。
1.1.5 主体
用于描述变量的上下文意义。
一般地，由首字母大写的一个或者多个单词构成，要求用英语作为描述语言。如：FileName，
DateTime。这样就形成了由大小字母夹杂的单词串，这种写法常见于Windows风格的编码。
注：全部单词小写，单词之间使用下划线分割，例如：file_name，date_time。这种写法常见于UNIX风格的编码。但是这种命名方式就不能很好地区分缀和主体，所以在本规范中是不推荐的。
单个的变量声明使用单数形式，不加任何冠词。例如：
CFile _file;
数组使用名词复数形式。
CFile _files[3];
一些容器类的作用类似于数组，所以也使用复数命名，例如：
CArray _arrayFiles;
std::list
1.2 按作用域分类讨论变量命名
1.2.1 参数变量
函数的参数变量要求由后下划线结尾（见作用域缀一节）。在一些纯数学函数中，也可省去数值类型前缀n，其它类型前缀不能省略。例如：
bool Create(PCTSTR pszPathName_);
double Add(double a_, double b_); // 值类型前缀省略
1.2.2 局部变量
由前下划线开头。在纯数学函数中，或者简短的上下文中，也可省去数值类型前缀n，其它类型前缀不能省略。
bool _bRet;
char _szBuffer[_MAX_PATH]
// 下面是一些值类型前缀省略的例子
int _i; // 常表示循环变量
int _temp;
for (int _i = 0; _i < _countof(_szBuffer); _i++)
{
float _a; // _a的作用域很短，所以可以省略
}
1.2.3 全局变量
使用作用域前缀’g_’。全局变量因为作用域很大，所以命名一定要规范。名称的主体部分必须能清晰说明变量的意义，并且不得有不规范的缩写。例如：
CWinApp g_Application;
int g_nVersion;
HINSTANCE g_hInstance;
1.2.4 静态变量
使用作用域前缀’s_’。局部静态变量使用前缀’_s_’，注意看下面的例子。例如：
CNcWinApp s_App;
int s_nVersion;
HINSTANCE s_hInst;
void f()
{
static int _s_nCallTimes;
}
1.2.5 其他例子
下面是变量命名的一些例子：
extern HINSTANCE g_hInst; //全局变量
static int s_nTimer = 0; //全局静态变量
int func(int nCounter_, int* pnSize_) //参数变量
{
//局部变量
long _nTotalItem;
static long _s_nCount = 0;
int _nVar;
LPSTR _pszBuffer;
TCHAR _szCache[_MAX_PATH];
int _var1; // 省去类型前缀
}
1.3 常数
目前本规范对常数类的命名规范还不是非常清晰。很多常数作用域也很大，类似于全局变量，所以命名一定要规范。名称的主体部分必须能清晰说明变量的意义，并且不得有不规范的缩写。
常数分成以下几类讨论。
1.3.1 宏定义的常数
#define定义的常数要求用大写字母和下划线混合命名，但是并不强制要求在每个单词之间插入下划线。如：
#define LEFT 0 // okay
#define RIGHT 1 // okay
#define UP_DOWN 1 // okay
#define Right 1 // not recommended
1.3.2 const定义的常数
（未完成）
const常数员命名既可以遵循一般变量命名法则；也可以遵循常数命名法则；
1.3.3 枚举
（未完成）
枚举命名：枚举名服从一般变量命名法则。
枚举成员命名：枚举成员名既可以遵循一般变量命名法则；也可以遵循常数命名法则；
1.4 函数命名规范
函数命名采用大小写夹杂的动宾结构命名。如：
int GetLastError(); // okay
int getlasterror(); // 全小写，不推荐
int get_last_error(); //全小写，不推荐
int OpenFile(); // okay
int FileOpen(); // 非动宾结构，不推荐
属于同一类的一组函数可以使用共同前缀来标识。如：
int NetGetError();
int NetOpen();
int NetClose();
int NetSend();
int NetReceive();
内部实现函数可以使用前下划线作为前缀，例如：
class MyClass
{
// . . .
private:
void _init();
};
仅在某一个代码文件使用的内部实现函数应定义为静态函数，这可以避免作用域冲突。
1.5 结构命名规范
结构命名：结构名服从一般变量命名法则。
结构成员命名：结构变量名服从一般变量命名法则。如：
struct DateTime
{
int nYear;
int nMonth;
int nDay;
int nHour;
int nMinite;
int nSecond;
};
本规范不采用对结构成员使用表示结构的前缀。如：
struct DateTime
{
int dtYear; // error
int dtMonth; // error
int dtDay; // error
int dtHour; // error
int dtMinite; // error
int dtSecond; // error
};
一般说来，结构中不包含成员函数（偶尔，仅仅包含构造函数是允许的）。如果希望把结构改造成包含丰富成员函数的对象，那样的话，请使用类（class）。其命名规范见下面叙述。
1.6 类（class）
1.6.1 类布局
在类中，推荐先是public节的内容，然后是protected节，最后是private节。也推荐参考MFC的类布局，使用
// Construction
// Attributes
// Operations
// Overrides
// Implementation
等注释来布局。
1.6.2 类成员
类成员变量：遵循一般变量命名法则，同时要求使用’m_’前缀。
类成员函数：遵循一般函数命名法则；
嵌套类、枚举、嵌套结构：遵循一般类、结构命名法则；
综合以上，举一例如：
class MyClass :: public BaseClass
{
public: //first
MyClass();
~MyClass();
protected: //then
int m_nVar1;
int m_nVar2;
private: //last
int DoSomething();
};
2 布局规范
需要注意的是，非公共接口的结构、类、常数、函数原形不要放在公共头文件中，而是应该放在私有头文件或实现文件中。
2.1 文件标头
文件标头必须包括版权说明、简短介绍。下面是文件标头的一个例子：
// Copyright (c) Naiky Company. All rights reserved.
//
// Abstract:
//
///////////////////////////////////////////////////////////
#include . . .
#include . . .
#include . . .
#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif
自VC6.0以来，new/delete操作增加了调试版本，对检测内存泄露非常有帮助。所以上面的代码包含这部分内容。
2.2 函数说明
函数说明是可选的。可以使用中文或者英文编写。
一般说来，公开接口、公共函数应该有说明，这样便于代码维护。
函数说明有两个地方可以放，一是放在函数声明中，而是放在函数实现中。这两个地方的函数说明有所不同。
函数声明处的说明：
此处的说明目的是告诉使用者，该函数的用法以及应该注意的问题，应包括函数的作用、入口参数和返回值说明，以及需要注意的声明内容。
下面是一个声明处说明的例子：
//Description:
// [You can fill some description here ]
//
//Entries:
// [Parameter1] [about Parameter1]
// [Parameter2] [about Parameter2]
// [Parameter3] [about Parameter3]
//
//Return:
// [about return value]
//[Note:]
// [this is an optional section]
函数实现处的说明：
此处的说明目的是告诉代码维护人员，该函数实现的细节以及在实现过程中需要注意的问题。
以下是摘自实际代码的一个例子：
/****
DESCRIPTION:
Get the distance from a 3d-point to a 3d-line.
ALGORITHM:
A line in 3D is given by the parametric vector with parameter t:
/ x0 + (x1 - x0) * t \
L = | y0 + (y1 - y0) * t | -----------------------(1)
\ z0 + (z1 - z0) * t /
A given point is
P = (u1, v1, w1)
The distance between the point and the line is therefore
r^2 = (u1 - x0 - (x1 - x0)*t)^2
+ (v1 - y0 - (y1 - y0)*t)^2
+ (w1 - z0 - (z1 - z0)*t)^2 ----------------------(2) To minimize the distance, take
d(r^2) / dt = 0 -------------------------(3)
assume that
a = (x1 - x0) u = (u1 - x0)
b = (y1 - y0) v = (v1 - y0)
c = (z1 - z0) w = (w1 - z0)
therefore
-2a * (u - a*t) - 2b(v - b*t) - 2c(w - c*t) = 0 -------(4) therefore
a*u + b*v + c*w
t = ------------------ ------------------------(5) a*a + b*b + c*c
reference to (2), get
r^2 = (u - a*t)^2 + (v - b*t)^2 + (w - c*t)^2 -----------(6) PARAMETERS:
POINT3DD point_ the given point
POINT3DD line0_, POINT3DD line1_ the given line RETURNS:
the power 2 of the distance
****/
inline double distance2_point_line(POINT3DD point_, POINT3DD line0_, POINT3DD line1_)
{
// . . .
}
2.3 代码布局
代码使用制表符缩进，制表符宽度为4。
代码行宽一般不超过80列（不过，现在的显示器越来越大，阅读更加方便，所以可以考虑把代码行宽设定到100列）。超过的部分折行到下一行，折行要求缩进一个制表符。
2.3.1 空格使用规范
保留字后面空一格。如：
for (int _i = 0; _i < 3; _i++) // okey
for(int _i = 0; _i < 3; _i++) // not recommended
while (true) // ok
while(true) // not recommended
if (a == b) // ok
switch (sw) // ok
双目操作符左右各空一格，括号（(，)，[，]）左右不空格。如：
a =
b = c; // ok
a=b=c; // not recommended
a = (
b == c) // ok
a = (b==c) // not recommended
a = (
b ==
c ) // not recommended
a = (
b == (c&d)) // not recommended
a = b[1] // ok
a = b[ 1 ] // not recommended
if (a == b) // ok
if ( a == b ) // not recommended
单目操作符不空格
a++; // ok
++a; // ok
a * -b; // ok
~a // ok
逗号、分号前面紧贴上一个字符，后面空一格。如：
func(int a_, int b_, int c_) // ok
func(int a_,int b_,int c_) // not recommended
func(int a_ , int b_ , int c_) // not recommended
for (int _loop = 0; _loop < _MAX; _loop++) // ok
for (int _loop = 0;_loop < _MAX;_loop++) // not recommended
变量（常量）的类型、名称及其它修饰符之间使用空格，而不是制表符分开，例如：int _nVar1 = 0; // ok
double _nVar2 = 1.0;
long _nVar3 = 2;
DWORD _nVar4 = 0xFFFF;
const float c_nMAX_VAL = 99999.9999;
int _nVar1 = 0; // not recommended
double _nVar2 = 1.0;
long _nVar3 = 2;
DWORD _nVar4 = 0xFFFF;
2.3.2 指针符位置
指针贴近类型，而不是变量。如：
// following lines are fine and recommended style!
long* _PnVar3 = GetPointer();
DWORD* _nVar4 = (DWORD*)0xFFFF;
const char* _pszString = “This is a test string”;
// not recommended!
long *_PnVar3 = GetPointer();
DWORD *_nVar4 = (DWORD*)0xFFFF;
const char *_pszString = “This is a test string”;
在VC6.0环境下，我们设计了宏StandardFormat用来格式化代码。可以完成大部分格式化工作。也可以用VC++中Edit |Advanced| Tabify Selection和Edit| Advanced| Untabify Selection命令来格式化代码。
下面是一些推荐布局风格：
// Ex. 1
if (a == b)
{
//some code here
}
// Ex. 2
switch (_nSwitchVar)
{
case 1:
{
//some code here
int _temp = // . . .
}
break;
case 2:
f(2);
break;
case 3:
f(3);
break;
default:
assert(false);
break;
}
不推荐风格：
if (a == b){
//some code here
}
3 语法风格
避免不好的语法习惯。
3.1 关于if
不要在if表达式中使用’=’。例如：
int _a;
if (_a = GetValue())
{
//some code here
}
应该写为：
int _a = GetValue();
if (_a) //or if (_a != 0)
{
//some code here
}
下面的代码实际上可能并不按你想象的方式运行：
if (a == b)
if (d == e)
x = 1;
else
func();
3.2 变量声明与定义
不要使用未赋初值的变量，尤其是指针：
int _a;
if (GetSomeValue() == OK)
_a = 100;
Func(a); //at some cases, “a” has not get an initial value here 3.3 关于宏
不要在宏中使用表达式或者调用函数：
#define __max(a, b) ((a) > (b) ? (a) : (b))
__max(func(), 3) // not recommended!!!
__max(var++, 3) // not recommended!!!
int _a = func();
__max(_a, 3) // okey
尽量使用inline函数代替函数宏。
尽量使用const代替常数宏。
3.4 测试代码
一些测试代码要用_DEBUG包围起来。
// bad code!!!
if (pszBuffer)
{
ASSERT(strlen(pszBuffer) < 100);
}
// good code
#ifdef _DEBUG
if (pszBuffer)
{
ASSERT(strlen(pszBuffer) < 100);
}
#endif
4 注释
关于代码注释原则有两条：
1、代码中注释原则上不少于代码量的20%，最低不得少于代码量的10%；
2、在进行Bug维护时，功能维护单的内容必须全部出现在代码中，否则在代码最终评审时会进行相应的扣分。
程序代码注释编写规范 为提高控制程序的阅读性与可理解性，现制定相关代码程序代码注释编写的编写规范。 一般情况下，源程序有效注释量必须在20％以上，注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"//"符号开始，任何位于该符号之后的本行文字都视为注释。 多行:以"/*"符号开始，以"*/"结束。任何介于这对符号之间的文字都视为注释。 一、说明性文件 说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************* COPYRIGHT (C), MicTiVo International. Co., Ltd. File NAME: // 文件 Author: Version: Date: // 作者、版本及完成日期 DESCRIPTION: // 用于详细说明此程序文件完成的主要功能，与其他模块 // 或函数的接口，输出值、取值范围、含义及参数间的控 // 制、顺序、独立或依赖等关系 Others: // 其它内容的说明 Function List: // 主要函数列表，每条记录应包括函数名及功能简要说明 1.... History: // 修改历史记录列表，每条修改记录应包括修改日期、修改 // 者及修改内容简述 1. Date: Author: Modification: 2. .. *************************************************/ 二、源文件头 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************************ COPYRIGHT (C), MicTiVo International. Co., Ltd. FileName: Author:
公司电子邮件使用规范 V1.0版 为进一步规范电子邮件的使用，提高沟通效率，进而提高工作效率。现对公司电子邮件的使用作如下规定： 一、邮件文本及格式规范 1.邮件内容 一封完整的电子邮件内容包括：收件人邮件地址（抄送人邮件地址）、邮件主题、收件人称呼、邮件正文、邮件结束语、本人签名。 2.邮件字体 ①全文使用统一字体; ②字体大小在10-12号之间，汉字和数字统一使用宋体，英文使用Arial; ③不使用其它字体效果（如斜体、下划线、删除线等）; ④字体颜色为黑色，需要重点突出的内容可加粗或使用红色标注。 3.邮件信纸 公司目前还未规范统一的信纸模板，建议暂不使用信纸。 4.个人签名 要求统一使用公司的签名模板。 二、邮件内容规范 1.语言表述清晰，简练，没有歧义； 2.规范用语，尽量少用口头用语，不用俚语； 3.段落分明、清晰； 4.各类、各级的请示、回复、传达、公务督办等工作沟通与协调可通过邮件传达； 5.上级对下级的任务指派也可使用邮件传达，但邮件中必须注明具体的任务要求； 6.内部员工不得使用公司邮箱进行问题交流与讨论，浪费公司邮箱资源； 7.员工不得使用公司邮箱发送与工作内容无关的邮件，不得利用企业邮箱上传、展示或传播任 何虚假、骚扰性、中伤他人、辱骂性、恐吓性、庸俗淫秽或其它任何与政治、宗教相关的信息资料。 三、邮件发送规范
1.邮件主题 ①邮件必须写明主题； ②主题要明确清晰，文字简练，让收件人了解邮件的大概内容，不能有歧义。 2.邮件发送 ①邮件内容要注意保密性，明确收件人范围，不遗漏需要发送的人，也不发送给无关人员； ②明确收件人和抄送人，避免两者混淆不分，收件人为必须知悉该邮件内容的当事人（事 件主要责任人），抄送人为有必要了解该邮件内容人员（事件相关知情人）； ③转发邮件时，要注意内容保密性，检查原邮件内容，确定需要引用的内容； ④连续回复、转发邮件，需要重新整理和明确邮件内容，避免沟通有误； ⑤邮件发送前，认真检查，确认无误后再发送。 3.邮件优先级及回执 ①邮件内容确实重要紧急的时候使用优先级； ②对于一些重要邮件，需要跟踪邮件是否及时送达并明确相关收件人是否已查看，可以 适当使用邮件回执功能； ③不要频繁使用邮件优先级和邮件回执功能。 四、其它注意事项 1.员工不得使用弱口令作为邮箱密码，不得将其帐号、密码转让或出借予他人使用，如发现 帐号遭他人非法使用，应立即向网络管理员汇报； 2.员工不得使用公司邮箱作为各类生活娱乐网站、论坛注册时的验证邮箱； 3.为保证邮件的沟通效率，要求员工每天在岗时间内必须开启邮件客户端，并设置成每十五 分钟自动收取，需及时查看新邮件，对于因未及时查看邮件或未及时回复，而导致工作延 误的，将对责任人进行严厉处罚； 4.邮件只是众多沟通方式中的一种，日常的沟通不能完全依赖邮件，尤其是需要及时响应的 工作沟通； 5.为不影响其他人正常使用邮件系统，对于大于20M的文件，不使用邮箱发送。 6.
1 Java 编程规范 1.1 排版 1.1.1 规则 规则1程序块要采用缩进风格编写，缩进的空格数为4个，不允许使用TAB缩进。(1.42+) 说明：缩进使程序更易阅读，使用空格缩进可以适应不同操作系统与不同开发工具。 规则2分界符（如大括号…{?和…}?）应各独占一行，同时与引用它们的语句左对齐。在函数体的开始、类和接口的定义、以及if、for、do、while、switch、case语句中的程序 或者static、,synchronized等语句块中都要采用如上的缩进方式。(1.42+) 示例: if (a>b) { doStart(); } 规则3较长的语句、表达式或参数（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐， 语句可读。(1.42+) 示例： if (logger.isDebugEnabled()) { logger.debug("Session destroyed,call-id" + event.getSession().getCallId()); } 规则4不允许把多个短语句写在一行中，即一行只写一条语句(1.42+) 说明：阅读代码更加清晰 示例：如下例子不符合规范。 Object o = new Object(); Object b = null; 规则5if, for, do, while, case, switch, default 等语句自占一行，且if, for, do, while,switch等语句的执行语句无论多少都要加括号{},case 的执行语句中如果定义变量必须加括号{}。 (1.42+) 说明：阅读代码更加清晰，减少错误产生 示例： if (a>b) { doStart(); }
公司电子邮件使用规范集团文件发布号：（9816-UATWW-MWUB-WUNN-INNUL-DQQTY-
公司电子邮件使用规范 一、邮件文本及格式规范： 1 邮件内容： 一封完整的电子邮件内容包括：收件人邮件地址（抄送邮件地址）、邮件主题、收件人称呼、邮件正文、邮件结束语、本人签名、发件日期，有明显称呼、签名、日期的邮件，能使查阅者一目了然。 2邮件字体： （1）全文统一； （2）字体大小适宜,不宜过大或过小,选用宋体字； （3）字体为正体； （4）字体颜色为黑色，个别重点处可加黑、加大或显着的颜色。 3邮件附件： 如邮件中含有附件及附件数量，应在邮件内容中说明。 4邮件格式：使用公司统一的Logo及信纸格式，如无信纸格式，则不使用信纸。 5个人签名： （1）个人签名档需包括内容：姓名、所在部门/岗位、联系方式、电话分机、传真、 e-mail等； （2）如有工作需要，需和外部联系，还可以增加公司名称、地址、邮政编码、公司网站及个人手机号码，skype号等。 二、邮件语言文字规范： 1语言表述清楚、简练，不能有岐义。
2规范用语，尽量少用口头用语，不用俚语。 3 段落分明、清晰。 4 用语忌言辞激烈及过分表露个人情绪。 三、邮件发送规范： 1邮件主题：邮件必须写明主题。 2邮件发送： （1）邮件内容需注意保密性，要明确收件人的范围，不遗漏需要发送的人，不发给无关人员； （2）涉及企业内部操作的信息，不要发送邮件； （3）敏感信息，需要用隐晦的表达方式； （4）决定性、关键性内容要点应在正文中描述，附件只作为详细分解说明； （5）明确主送人和抄送人，避免两者混淆不分，主送人为必须知悉该邮件内容的当事人，涉及请示、问询等内容的，或需要指示、告知时，主送人一般需要回复邮件，抄送人为有必要了解该邮件内容的人员； （6）慎重考虑邮件发送人员，重要和必须了解的信息，抄送上级领导或横向部门领导； （7）转发邮件时，要注意内容保密性，检查原邮件内容，确定需要 引用的内容； （8）连续回复、转发邮件,要重新整理和明确邮件内容,避免沟通有 误； （9）接受抄送邮件人员，一般不需要回复；
电子邮件书写规范及注意事项 寄送电子邮件时的礼貌，和与客户电话交谈或亲自拜访客户时的礼节一样重要。电子邮件需要的礼节可能不同，但目的却是一样的。 不同的是，对方在读信时你并不会在场，所以无法像在讲电话或面谈时判断对方的反应。按下[发送] 按钮寄出邮件后，就无法再改变你做出的意见了。万一发现存在错误，虽然可以尽快纠正，但也已经给对方留下一定印象。因此，请务必注意一些电子邮件守则： 1、写邮件就像写信一样。以必要的礼貌，去向对方表达自己的恭敬之意。其中的一个重要做法，就是要尽量多使用谦词或敬语。邮件具备有帮助性的内容和友善的语气，通常是非常容易获得客户的重视和认可的。 请在邮件中注明公司名称，使用恰当的称呼语和较正式的语气。例如： 致：××公司 尊敬的×小姐： 2、要有明确的主题，邮件内容要简洁明了、针对性强。 使用简单易懂的主题以准确传达电子邮件的要点，无主题或者是主题说明不清楚的，很有可能被反垃圾邮件程序过滤掉，就是正常收到，日后检索或是导入其他邮件管理工具也将造成很多不必要的麻烦，这点非常重要！主题要求简明扼要，字数控制在30个汉字以内。尽可能避免出现类似“RE:RE:RE:FW:FW:XXXXXX”的多重标签字样。由于我们自己的机器装有杀毒软件，在收到客户的邮件时，邮件标题可能有杀毒软件的提醒，“此邮件可能为垃圾邮件”的字样，回复时记得要去掉，否则容易引起客户的误会！ 邮件内容要求语言简洁，让客户能在最短的时间内了解到邮件的主旨，以便客户节省时间，提高工作效率。如果邮件过于冗长，且语句罗嗦，客户一般不太愿意仔细阅读，更不容易引起重视。 如果是在邮件中拒绝客户的某些要求，建议尽量避免用一些简短生硬的语句，一定要语气委婉并讲明原因，最好能站在客户立场上去考虑且说明。 给客户建议要尽量简明扼要，并说明此建议的优点及建议原因。 给客户的邮件中，尽量避免使用公司内部的专用词汇及过于专业的网络用语，如我们内部简称Toprank为TR，数据不同步等。要尽量通俗易懂，但不能显得很外行。 邮件中不要评论竞争对手，不要涉及一些不便公开的事情或者一些不确定的事情，保守商业秘密。 太复杂的问题还是用电话沟通（如排名等），邮件不易表达清楚。
程序编写规范及约定 (仅供内部使用) 文档作者：_______________ 日期：___/___/___ 开发/测试经理：_______________ 日期：___/___/___ 项目经理：_______________ 日期：___/___/___ 请在这里输入公司名称 版权所有不得复制
目录 程序编写规范及约定 (3) 1编写目的 (3) 2代码编写风格 (3) 2.1单元风格 (3) 2.2语句风格 (3) 3命名规则 (3) 3.1命名约定 (3) 3.1.1标志符 (3) 3.1.2类class (3) 3.1.3枚举类型enum (4) 3.1.4委托delegate (4) 3.1.5常量const (4) 3.1.6接口interface (4) 3.1.7方法function (4) 3.1.8命名空间namespace (4) 3.1.9参数 (4) 3.1.10局部变量 (5) 3.1.11数据成员 (5) 3.1.12自定义异常类 (5) 3.1.13命名缩写 (5) 3.1.14数据库命名 (5) 3.2代码编写命名规范 (6) 3.3界面常用控件命名约定 (6) 3.4文件命名规范 (7) 3.4.1文档文件命名 (7) 3.4.2配置文件命名 (7) 3.4.3程序文件命名 (7)
程序编写规范及约定 1编写目的 为了使编写代码具有可读性、可理解性、可维护性，对程序编写人员代码实行统一风格，使得程序代码能够以名称反映含义、以形式反映结构。此文档可供程序代码编写人员及代码维护人员使用。 2代码编写风格 2.1单元风格 2.2语句风格 3命名规则 3.1命名约定 Pascal和Camel命名约定： 编程的命名方式主要有Pascal和Camel两种（Pascal：每个单词的首字母大写，例如ProductType；Camel：首个单词的首字母小写，其余单词的首字母大写，例如productType） 3.1.1标志符 规则：Pascal、Camel 实例与描述：例子说明 3.1.2类class 规则：Pascal 实例与描述：Application
电子邮件的礼仪和企业电子邮件规范 电子邮件的礼仪 Netiquette（网络礼仪）的范围很广，在这里我们只说其中的一部分——email etiquette（electronic mail etiquette，电子邮件的礼仪），它是每一位职业人士都应该遵循的日常商务礼仪规范。 必须回复 电子邮件如同通电话，正如你不应该让电话铃声响太久才接听一样。无论对方来信是提问还是问好，你都必须尽快回复。不过，如果你没有经常查看邮箱的习惯，你应该把这种习惯告诉他人。 必须写主题 这是一种职业行为。通常人们会根据主题判断邮件的重要性，一般来说，没有主题的邮件往往会被忽略，到最后才看。因此，通过主题让他人对邮件的内容一目了然，会加快对方同复邮件的速度。 内容简练 写电子邮件切忌长篇大论，应尽量简单明了地表达。 注意礼貌 发送电子邮件必须注意礼貌，用词要得当，以免引起误解或给收信人留下不好的印象。 注意字体 字体大小要适中，不要选择让人难以阅读的字体。此外，如果写英文邮件，特别注意不要全用大写。 例如，I WILL CALL YOU TOMORROW. 这句话全用了大写，表示喊叫的语气，大声地对收件人说这句话，显得很没礼貌。正确的表达应该是：I will call you tomorrow. 注意编码 有些语言用不同的客户端会出现乱码现象，中文邮件应该选择GB2312的编码。
保持专业 避免利用工作的电子邮箱发送私人邮件。 避免传递无关信件 “Spam”或“Junk mail”（垃圾邮件）是令人厌烦的，所以不要发送对方不感兴趣的邮件。 尊重隐私 有些人并不愿意他们的邮箱地址出现在其他人的邮件中，所以当群发邮件的时候，要考虑对他人隐私的尊重。 小心使用抄送（CC）/ 密送（BCC）功能 抄送（CC）是指发送给收件人的同时，也让其他一人或多人收到该封邮件，并且也让收件人知道这种情况。密送（BCC）的功能也差不多，其区别是收件人并不知道你同时也把该邮件发送给了其他人。 小心使用附件功能 信件内容不多时，应该以正文形式发送邮件。发送图片、影像或文字量较多的文档时可以通过附件发送，并且要考虑文件是否超过收件人能接受的空间。同时发送多个文件或比较大的文件时，可以先压缩后再发送。 小心使用表情字符 适当使用表情字符可以表达幽默，让人感觉轻松与亲切。但在发送前你必须确认收件人能领会字符的含义。以下是常见的表情字符： 表情字符含义 :-) 或 :) 微笑 :-> 露齿笑 :-P 歪嘴笑、吐舌头 ;-) 眨眼 :-( 不高兴 表情字符含义 :-| 不感兴趣 :-/ 困惑 :-e 失望 :-@ 尖叫 :-O 喊叫、惊讶 小心使用缩写
电子邮件使用规范 1、关于邮件主题 主题是接收者了解邮件的第一信息，因此要提纲挈领，使用有意义的主题行，这样可以让收件人迅速了解邮件内容并判断其重要性。 1.1 一定不要空白标题，这是最失礼的。 1.2 标题要简短，不宜冗长。 1.3 标题要能反映邮件的内容和重要性，切忌使用含义不清的标题。 1.4 一封信尽可能只针对一个主题，不在一封信内谈及多件事情，以便于日后整理。 1.5 回复对方邮件时，可以根据回复内容需要更改标题，不要RE（回复）、RE（回复） 一大串。 1.6 可适当用使用大写字母或特殊字符（如“* !”等）来突出标题，引起收件人注 意，但应适度，特别是不要随便就用“紧急”之类的字眼。 2、关于称呼与问候 2.1 电子邮件的开头要称呼收件人。这既显得礼貌，也明确提醒某收件人，此邮件是 面向他的，要求其给出必要的回应；在多个收件人的情况下可以称呼“大家”。 2.2 如果对方有职务，一般职务尊称对方，如“X总”、“x经理”；如果对外沟通， 必须按照职务尊称对方。 2.3 电子邮件开头结尾最好要有问候语。例如：开头：“你好”、“您好”、“大家 好”、“各位好”…；结尾：“祝您工作顺利”……。 3、有关电子邮件礼仪 3.1 电子邮件正文要简明扼要，行文通顺。 3.1.1 电子邮件正文应简明扼要的说清楚事情；如果具体内容确实很多，正文应只作 摘要介绍，然后单独写个文件作为附件进行详细描述。 3.1.2 正文行文应通顺，多用简单词汇和短句，准确清晰的表达，不要出现让人晦涩 难懂的语句。 3.2注意电子邮件的论述语气。 3.2.1 根据收件人与自己的熟络程度、等级关系、邮件是对内还是对外性质的不同， 选择恰当的语气进行论述，以免引起对方不适。
百度文库- 让每个人平等地提升自我 1 程序代码注释编写规范 为提高控制程序的阅读性与可理解性，现制定相关代码程序代码注释编写的编写规范。 一般情况下，源程序有效注释量必须在20％以上，注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************* (C), MicTiVo International. Co., Ltd. 1.File : . History: Date: Author: Modification: 2. .. *************************************************/ 一、源文件头 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************************ (C), MicTiVo International. Co., Ltd. FileName: Author: Version : Date: : / /*receive _process() */ 意:与溢出中断写初值不同}
为规范公司邮箱的使用，现就邮件沟通礼仪、内容及签名等作以下规定，请大家仔细阅读、遵照执行。 邮件主题 1) 主题不要为空 . 主题为空会直接被收件人忽略当做垃圾邮件处理。 . 主题为空会让收件人不明所以，浪费时间。 2) 主题要明确 . 便于收件人迅速了解邮件内容并判断其重要性。 3) 每封邮件一个主题 . 便于收件人针对主题回复。 . 便于日后查找。 邮件内容 1) 礼貌的称呼与问候。 在电子邮件中，恰当的称呼收件人，既显得礼貌，也明确提醒某收件人，要求其给出必要的回应。 2) 简明扼要的正文 . 正文要简明扼要，行文通顺，信息要阐述完整。 . 要尽可能避免拼写错误和错别字。 . 需要短时间反复往来沟通的事务可以选择“即时通”（多人参加可以使用“邀请多人呢会话”方式）或电话，邮件不宜当成论坛使用，以免造成邮件堆积，浪费邮箱空间，扰乱收件人。 3) 明确日期与时间 . 日期建议日期的表达方式为：“下周三（2012/03/07）”“下个月（2012年3月）” . 时间标明“下午8:30”或采用24小时表示法：20:30 4) 注意附件 . 在邮件正文里面提示收件人查看附件。如“附件为会议记录，请注意查收。” . 附件名称要有意义 . 附件的数目不宜过多，较多时应打包压缩成一个文件。 5) 附带签名档 .标准签名档：请按行政部提供的格式设置好个人邮箱的签名。 字体：黑体，大字14号，小字10号，黑色。 . 商务函机密文件可以添加以下内容 ----------------------------
重要提示：此邮件及附件具保密性质，包含商业秘密、受法律保护不得泄露。如果您意外收到此邮件，特此提醒您此邮件的机密性，请立即通知我们并从您的系统中删除此邮件及附件。如果您不是此邮件应当的收件人，请注意不可对此邮件及其附件进行复制或向他人透露其内容。 IMPORTANT NOTE:This transmission and any attachments may contain legally privileged and/or confidential information intended for a specific individual and purpose and is protected by law. If you received this transmission in error, notify the sender and delete the original transmission and its attachments without reading or saving in any manner. Any disclosure, copying, distribution, or taking of any action based on this message is strictly prohibited. . 设置方法： 1) 网页邮箱设置签名 . 页面右上角“设置”→基本设置中“签名设置”→添加签名→编辑→确定 2) 闪电邮软件设置签名 . 邮箱→邮箱设置→信纸与签名→管理签名→新建签名→保存并关闭 邮件发送 1) 根据邮件需要谨慎处理抄送 . 不相关的人员不要抄送。 . 部门或系统内部未达成一致或未形成决议的内容不要大面积发送或抄送。 2) 及时回复 . 收到邮件后，应及时回复对方，不要置之不理。 . 注意，一旦点击“全部回复”后发送，将同时也会发往所有抄送者，同时被暗抄者地址信息将被公布于众。 3) 机密文件的发送方法 . 发送加密文件时注意密码与加密文件分别发送。 . 发送客户报价单、合同等资料时最好PDF化后发送。
程序代码注释编写规范 XXX份公司
为提高控制程序的阅读性与可理解性，现制定相关代码程序代码注释编写的编写规范。 一般情况下，源程序有效注释量必须在20％以上，注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"//"符号开始，任何位于该符号之后的本行文字都视为注释。 多行:以"/*"符号开始，以"*/"结束。任何介于这对符号之间的文字都视为注释。 一、说明性文件 说明性文件（如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等）头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等，头文件的注释中还应有函数功能简要说明。 示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************* COPYRIGHT (C), MicTiVo International. Co., Ltd. File NAME: // 文件 Author: Version: Date: // 作者、版本及完成日期 DESCRIPTION: // 用于详细说明此程序文件完成的主要功能，与其他模块 // 或函数的接口，输出值、取值范围、含义及参数间的控 // 制、顺序、独立或依赖等关系 Others: // 其它内容的说明 Function List: // 主要函数列表，每条记录应包括函数名及功能简要说明 1.... History: // 修改历史记录列表，每条修改记录应包括修改日期、修改 // 者及修改内容简述 1. Date: Author: Modification: 2. .. *************************************************/ 二、源文件头 源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例：下面这段源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。 /************************************************************
公司电子邮件管理规定范文 1．0 总则 公司开通Intemet电子邮件服务，目的是为了更好地促进公司员工工作的内外交流。公司的电子信息网络，无论对内对外均不得传递与本人工作无关的内容，违者视情节轻重给予批评、降薪、降职、辞退处分。 2．0 邮件服务器管理 办公室统一管理公司的电子服务器并负责电子邮件的开户、使用、维护和监督检查工作。 3．0 邮件开户须知 申请电子邮件开户必须首先填写“电子邮件开户申请表”，并在并在保密承诺书一栏中签字，然后交部门经理审核签字后，将申请表交到办公室邮件管理人员处开户，邮件管理员开户完成后填写“电子邮件开户回执”，并通知申请人。回执单上包含配置邮件客户终端软件所需信息和用户使用规则。 4．0 电子邮件使用规程 4．1 用户应当定期检查自己的邮箱，并取走邮件，以保证有户的邮箱只占用合理的磁盘空间。每个用户的邮箱不能大于10M，对于超过10M的邮箱，管理员有权删除邮箱中的两个月以前的旧邮件，以保证用户邮箱在10M以下。由于不遵守此项规定而不能造成的损失由用户自己负责。 4．2 禁止向异地发送大于2M的电子邮件，严禁使用FIDMAIL下载软件和使用电子邮件订阅新闻、杂志、论坛等。技术杂志由公司统一订阅，图书室集中管理，申请订阅者需首先填写“电子杂志订阅申请表”，然后提交图书室订阅，公司驻外机构可由系统主管审批后另行处理。 4．3 在公司内部使用电子邮件只能使用在公司开户的电子邮件地址，不可擅自使用其他任何邮件地址。 4．4 严禁转发有危害社会安全的言论和政治性评论文章的邮件及一切无聊邮件。 4．5 发送保密资料邮件，按资料级别不同分别对待。 4．5．1 秘密级：需由部门经理同意加密发送，由部门对资料的安全负责。 4．5．2 机密级：由部门经理签字同意，将发送的资料交办公室审核、存档，并由办公室负责发送。 4．5．3 绝密级：禁止在网上发送 5．0 监督检查工作 公司员工使用公司电子邮件需要接受办公室的监管，系统会自动将部分用户收发电子邮件
1、头文件包含Includes 2、私有类型定义 Private typedef 3、私有定义Private define 4、私有宏定义 Private macro 5、私有变量 Private variables 6、私有函数原型Private function prototypes 7、私有函数Private functions 8、私有函数前注释 /****************************************************************************** * * Function Name : FSMC_NOR_Init * Description : Configures the FSMC and GPIOs to interface with the NOR memory. * This function must be called before any write/read operation * on the NOR. * Input : None * Output : None * Return : None ******************************************************************************* / 9、程序块采用缩进风格编写，缩进空格为4。 10、相对独立的程序块之间、变量说明之后必须加空行； 11、较长的字符（>80字符）要分成多行书写，长表达式要在低优先级操作符划分新行，操作符放在新行之首，新行要恰当缩进，保持排版整齐； 12、循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首; 13、若函数或过程中的参数较长，则要进行适当的划分。 14、不允许把多个短语句写在一行中，即一行只写一条语句。 15、if、for、do、while、case、switch、default等语句自占一行，且if、for、 do、while等语句的执行语句部分无论多少都要加括号{}。 16、对齐只使用空格键，不使用TAB键； 17、 函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格，case 语句下的情况处理语句也要遵从语句缩进要求 18、 程序块的分界符（如C/C++语言的大括号‘{’和‘}’）应各独占一行并且位于同一 列，同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以 及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。 19、 在两个以上的关键字、变量、常量进行对等操作时，它们之间的操作符之前、之后或
. . 电子邮件书写规范 商务人士在使用电子邮件对外进行联络时，应当遵守一定的礼义规范，正确使用电子邮件，撰写规范的商务Email，顺利的进行对外联络。 撰写邮件有三种方式：写邮件、回复邮件、转发邮件。三种方式各有所长，但在撰写格式方面都一至分为四点：收件人，抄送，主题（标题），内容。 一、收件人 1.确认传送讯息的对象，并将人数降至最低。 2.传送电子讯息之前， 确认收信对象是否正确，以免造成不必要的困扰。 二、抄送 1.在必要和确定的情况下，抄送给相应需要知道进展情况的人员。 2. 一般情况下不要给普通客户抄送。 3.确认抄送讯息的对象，并将人数降至最低，以免造成不必要的困扰。 三、主题电子邮件一定要注明主题，因为有许多网络使用者是以主题来决定是 否继续详读信件的内容。此外，主题要明确、精练与内容相关，表达出对方需要了解的信息，而且可以区分对同一事物的不同信息。让人一望即知，以便对方快速了解与记忆。 四、内容在线沟通讲求时效，所以电子邮件的内容力求简明扼要，并求沟通效 益。一般信件所用的起头语、客套语、祝贺词等，在在线沟通时都可以省略。但称呼，正文，结束，落款/签名四点要尽量完整。 1、称呼1)如果有收件人的姓名的话,可以让对方感觉更加友好。2)若知道对方的性别可以用：**先生、**小姐、**女士3)如果知道对方的身份可以用：**总经理、**经理、**董事长、×总、×董、×经理 2、正文正文做到主题明确，语言流畅，内容简洁。在撰写正文时还应注意以下几点，以示礼貌和尊重，以免造成不必要的困扰。1)在撰写英文信函时,只对一两个词进行大写以示强调,全篇都用大写是不礼貌的。在撰写中文的时候，只对部分以示强调的词采用加粗等方式。2)不要在信件中发泄不满,应面对面的解决。3)回复信件时,有必要加上部分的原文,以方便对方了解回信内容。4)若摘录的原文很长,应先把回复内容放到前面,原文内容在后, 5)在收件人明白其意时,才可使用俚语或缩写。6)如果有附件，应该在正文处说明附件的内容和用途； 3、结束1)如果可提供好的选择,应在结尾处提出。如: 请您考虑，有任何需要咨询，请电话或EMAIL联系我. 2)最好的结尾要着眼未来：如：希望我们能够达成合作3)结尾应显示诚恳：如：感谢您抽空洽谈 4、落款/签名目前，有不少网民时常会因为自己的电子信箱中堆满了无数的无聊的电子邮件，甚至是陌生人的电子邮件而烦心不堪。对其进行处理，不仅会浪费自己的时间和精力，而且还有可能会耽搁自己的正事，鉴于此，在商务邮件中应该有落款/签名，以示身份
信息安全管理办法 （电子邮件的安全使用规范） 第一章总则 第一条电子邮件规范的目的是建立公司电子邮件的使用规则：包括电子邮件的发送，接收，或存放。 第二条该规范适用于以公司企业邮箱发送、接收或者存储电子邮件的，被赋予访问信息资源的所有个人。 第二章规范内容 第三条以下活动是被明确禁止的： -发送威胁或骚扰性的电子邮件； -使用电子邮件做个人业务； -使用电子邮件用于政治游说或竞选； -通过电子邮件复制和发布受版权保护的信息、知识和软件； -冒用他人名义发送电子邮件。不包括作为系统管理支持角色的身份，经他人授权使用的情况； 第四条禁止以下活动，因为其可能妨碍网络通信和电子邮件系统的正常操作： -发送或转发链信件； -发送过大的信件； -发送或者转发可能包含计算机病毒的电子邮件。 第五条个人不能通过“非公司电子邮件帐号”发送，转发或接
收机密或敏感的公司信息。“非公司电子邮件帐号”包括但不限于：Hotmail、雅虎邮件、163邮件、新浪邮件和由其它网络服务提供商提供的电子邮件 (ISP) 。 第六条公司企业邮箱由专人负责管理，企业邮箱账户限本人使用，禁止将本人账户转借或借用他人账户。 第七条为保障邮件服务器稳定可靠地运行，所有用户应及时检查自己的邮箱并下载邮件，以防邮箱超过限额影响使用。违者责任自负。 第八条公司提供的电子邮箱仅限工作用途，不得用于私人事务，禁止因非工作用途将邮件账户公开于外部internet网上。 第九条发送带有公司涉密信息的邮件，发件人必须先经部门领导同意（若是绝密级别，需经副总裁以上领导同意），并将涉密信息加密处理后方可发送；否则将视情节予以严肃处理，直至追究法律责任。 第十条个人不能通过非公司检定的移动设备发送，转发、接收和存储公司机密或敏感的信息。移动设备的例子包括但不限于：个人数据助理PDA、移动电话等。 第十一条个人应负责对邮箱内重要邮件做备份。 第三章执行措施 第十二条任何违反上述安全规范的人员和服务单位将会依照
邮件EDM模板制作规范 第一部分邮件模板概括 1、邮件类型： 1) 新闻订阅；一般文字内容居多，每段文字具有相应的链接可供点击，同时加入少量图片进行点缀，模板顶部带有显著的公司logo和邮件发送内容标示，模板底部具有公司的联系方式，免责申明等栏目，邮件通常大于50K。 2) 产品订阅；一般图片内容为主，图片带有相应的链接可供点击，目的是有针对性的介绍最新的产品或活动信息，由于采用图片为主的形式，邮件大小通常在20k以内。 注：以上类型的模板制作均采用标准的html语言，并插入具有绝对地址链接的图片和链接。 2、邮件模板显示尺寸： 考虑到现在显示器不同分辩率的问题，一般建议邮件模板的显示宽度为800px至1024px之间；模板高度在1280px左右（即用户之需要一次滚动屏幕就可浏览全部内容）。 模板最佳尺寸：显示宽度400px-800px，模板高度控制在一屏以内。
3、标准邮件模板中需包括以下内容： 1) 标准页眉页脚应用 必须含有邮件无法正常显示的引导入口，如下的类似文字，如：如果无法浏览此邮件，请点击这里；另外，最好建议用户将发件人加入联系人列表。必须含有明显的退订链接标示（退订链接可直接由发送系统提供或链接到用户自己提供的退订链接）； 2) 其他页眉页脚应用 表明邮件的主要目的 邮件退订 选择订阅内容 修改订阅邮箱 隐私保护说明 企业服务标准等 注：目前网民使用的主流的浏览器有： 微软IE6 / IE7 / IE8、以IE为核心的遨游/Green、Google Chrome及FireFox，使用覆盖率超过90%；经过模板制作规范的建议修改后，以上浏览器均能正常显示模板。 第二部分静态页面的制作 一、内容比例
程序注释规范说明 程序注释规范应包括以下三方面： 一、文件头部注释 在代码文件的头部进行注释，这样做的好处在于，我们能对代码文件做变更跟踪。在代码头部分标注出创始人、创始时间、修改人、修改时间、代码的功能，这在团队开发中必不可少，它们可以使后来维护/修改的同伴在遇到问题时，在第一时间知道他应该向谁去寻求帮助，并且知道这个文件经历了多少次迭代、经历了多少个程序员的开发和修改。 样本： /***************************************************** ** 作者：Liuchao ** 创始时间：2007-11-12 ** 修改人：Liuchao ** 修改时间：2007-11-12 ** 修改人：Liaochao ** 修改时间：2007-11-12 ** 描述： ** 主要用于产品信息的资料录入，… *****************************************************/ 二、函数、属性、类等注释 请使用///三斜线注释，这种注释是基于XML的，不仅能导出XML制作帮助文档，而且在各个函数、属性、类等的使用中，编辑环境会自动带出注释，方便你的开发。以protected，protected Internal，public声明的定义注释都建议以这样命名方法。 例如： ///
/// 用于从ERP系统中捞出产品信息的类 /// class ProductTypeCollector { … } 三、逻辑点注释 在我们认为逻辑性较强的地方加入注释，说明这段程序的逻辑是怎样的，以方便我们自己后来的理解以及其他人的理解，并且这样还可以在一定程度上排除BUG。在注释中写明我们的逻辑思想，对照程序，判断程序是否符合我们的初衷，如果不是，则我们应该仔细思考耀修改的是注释还是程序了… 四、变量注释 我们在认为重要的变量后加以注释，说明变量的含义，以方便我们自己后来的理解以及其他人的理解，并且这样还可以在一定程度上排除BUG.我们常用///三斜线注释。 /// 用于从ERP系统中捞出产品信息的类 class ProductTypeCollector { int STData;///
E-mail传送中的三种编码标准 一、编码的必要性 E－mail只能传送ASCII码(美国国家标准信息交换码)格式的文字信息，ASCII码是7位代码，非ASCII码格式的文件在传送过程中就需要，先编成7位的ASCII代码，然后才能通过E－mail进行传送；如果不经过编码，则在传送过程中会因为ASCII码7位的限制而被分解，分解之后只会让收信方看到一堆杂乱的ASCII字符。经过编码后的文件，在传送过程中可顺利传送，不会有“被截掉一位”的危险。但是收信方必须具有相应的解码程序，将这份经过编码的东西还原，才能看到发信人要传送的信息是什么。 有一点要注意：大部分的人认为“文本文件不需要编码”，但我们的中文是属于8位代码的文字，并不是标准的ASCII码格式，由于在国内中文是通行的文字，所以大部分的邮件服务器都已能够处理GB内码的文件，因而不需要做这种编码/解码的操作，可以直接传送。但如果要送中文邮件到国外，就需要经过这种转换才能传送，因为国外的邮件服务器是无法辨认中文内码的。中文码在经过一些不支持中文内码的传递主机时，依然会被截掉一位，造成文件支离破碎无法读取。而经过编码的中文邮件，收信人收到后将文件解码还原，也需要有中文系统才能看所写的中文信息。 二、常见的三种编码标准 ●UU编码(Unix－to－Unix encoding) uuencode和uudecode原来是unix系统中使用的编码和解码程序，后来被改写成为在DOS中亦可执行的程序。在早期传送非ASCII码的文件时，最常用的便是这种UU 编码方式。 使用的方法是：发邮件前，在DOS下先用uuencod e exe程序将原文件编码成ASCII码文件，然后将邮件发出。收信人收到邮件后，用uudecode exe程序将文件还原。 基于Windows的类似程序有wincode和winzip等。wincode的使用原理和DOS 下的uuencode和uudecode没什么两样，只是在Windows的界面下操作更为简便。wincode除支持UU编码外也支持MIME、Binhex等编码格式，应用范围颇为广泛。 以上介绍的UU编码并非只能编中文文字。任何你要寄送的文件包括exe等二进制文件都可以按照编码→发送→收信方收信→解码还原的步骤传送。 ●MIME标准(Multipurpose Internet Mail Exte ntions) UU编码解决了E－mail只能传送ASCII文件的问题。但这种方式其实并不是很方便，因而又发展出一种新的编码标准，其全名是Multipurpose Internet Mail Exten tions，一般译作“多媒体邮件传送模式”。顾名思义，它可以传送多媒体文件，在一封电子邮件中附加各种格式文件一起送出。 MIME标准现已成为Internet电子邮件的主流。它的好处是以物件作为包装方式，可将多种不同文件一起打包后传送。发信人只要将要传送的文件选好，它在传送时即时编码，收信人的软件收到也是即时解码还原，完全自动化，非常方便。当然先决条件是双方的软件都必须具有这种功能，要不然发信人很方便地把信送出去了，但收信人的软件如果没有这种功能，无法把它还原，看到的也就是一大堆乱码了。使用这种方式，用户根本不需要知道它是如何编码/解码的。即使只是用文字写的信，一样是打好包便寄出。如果是要寄多媒体文件，只要做选文件的动作，选完后寄出，其余的工作由电子邮件软件自动完成。由于MIME的方便