代码规范文档(篇一)

JAVA程序有两类注释：一类是实现性注释（implementation comments），另一类是文档型注释（documentation comments）。其中，Implementation 注释有C和C++两种格式，/*...*/ 和//。文档型注释是JAVA程序所独有的，在/**...*/中限定。文档型注释能够被javadoc文件工具提取到HTML文件中。

Implementation注释用于注释代码或者注释特殊的实现。文档型注释主要是描述代码段的说明，从一种非面向实现的角度来写给开发人员阅读读，这些开发人员可能手边并没有源代码。

通常注释应该是给代码一个总的描述或者提供从代码本身不太容易看出的附加性信息。注释的内容应只与读代码和理解代码有关。例如，关于相应的包（package）是如何构建，以及存放在什么目录中，不应该包括在注释中。对代码中不太明显的设计意图进行说明是应该的，但也应避免对一些明显的信息进行重复说明，尽量避免那些随着代码的维护会过时的注释。

注意：

过于频繁的注释常常意味着代码质量较低。但你觉得必须频繁添加注释时，应考虑重写该段代码了。

注释内容不应封在星号（*）或者其它字母围成的矩形框中；注释中不应带有特殊注释字符如制表符（form-feed）和退格符（backspace）。

代码规范文档(篇二)

生活本是不易的，每个人都为了生而努力的活着。

或许现在的我们都能快快乐乐的坐在教室里安静的学习，每天都在为自己的学业而奋斗!很安逸!没有经济上的负担，没有太多的琐事琐事困拢着你，没有沉重的责任压在你身上......可你知道吗?你没有体会过生活苦的滋味，这些的这些都是最爱你的人在为你默默承担者，而那个人就是你的父母。

生活真不容易，爸妈为了养家糊口每天起早贪黑，早出晚归地做小本生意，而这不是一两天的事，而是坚持了十几年!作为家里最大的孩子，就应该帮爸妈分担一些事情!所以，我一放假，就去档口帮爸妈打下手，从早上天还未亮就出门一直到晚上的_点才收档，节假日有时更晚收档11点多才收。干完活回到家整个人都是”累成狗“的样子!

从那时起，我便知道了挣钱的不易，父母养家糊口的不易，更加懂得了生活也是真的不容易.

所以，当我看见有人随意挥霍父母的血汗钱，我都非常的愤怒，因为他们都不懂父母挣钱的辛苦，生活的不易!

没有吃过苦的人，他们没有体会过生活带给他们的苦，他们无法做到将心比心，他们或许会觉得生活就是眼前的这般美好!每天开心地玩，该学的学，不用去考虑太多的东西!

生活就是一面镜子，你哭它就对你哭，你笑它就对你笑，你怎样对待它，它就以怎样的方式对待你。

它或甘或苦，我们都需细细品尝它其中的韵味，哪怕不容易，好好珍惜我们现在所拥有的东西不要将某一物抛掉!

代码规范文档(篇三)

动物是人类的好朋友，我们应该爱护它们、保护它们。可今天的一幕却让我十分气愤。

今天，我在散步时觉得有些累，便准备休息一会儿，然后回家。忽然两个男孩吸引了我，他们一起拿着废弃的档杆，我开始没有看懂它们在干什么，后来，当他们将档杆对向鸟窝时，我才发现他们是要掏鸟窝，我想去阻止，可晚了，鸟窝已经“扑”的一声掉在了地上，我看不下去了，准备回家，可一不小心瞥见他们刚才掏的燕子窝，里面趴着奄奄一息的小燕子，嘴里发出近似绝望的般的微弱哀鸣声。看到这里一丝愧疚之意涌上心头。

等他们离开后，我想：如果幼鸟就这样死了，鸟妈妈一定会很伤心的。想到这里，我小心翼翼地将地上的鸟窝捡起来，然后用绳子将鸟窝绑在路边的小树枝丫上，以防幼鸟受到二次伤害。做完这些后，心里顿时轻松了许多，我便高兴的回家了。

回到家，我心想：他们长这么大，难道没有听说过要保护动物吗？它们可是一个鲜活的小生命呀！如果全世界的人都像他们一样，动物就会灭绝。我们的美好家园还怎么去创建？所以，关爱生命，共创美好未来的同时，也请我们一起保护动物吧！

代码规范文档(篇四)

北京20xx年统招本科按提前批、本科一批、本科二批、本科三批四个批次依次录取。6月25日8时至29日20时填报本科志愿。规则如下：

一、志愿设置

（一）统考统招本科志愿

统考统招本科招生高校按本科提前批、本科一批、本科二批、本科三批四个批次依次录取。

本科提前批按A、B、C三段顺序依次录取，每段均设置两个顺序志愿，每个志愿填报1所高校。艺术院校（专业）、体育院校（专业）、军事院校、武警部队院校、招收国防生的院校（专业）、公安类等院校（专业）在A段录取；“双培计划”和“外培计划”原则上在B段录取；“农村专项计划”在C段录取。本科一、二、三批均为平行志愿，分别可以填报6所平行志愿高校。以上每个志愿高校设置6个志愿专业，考生填报时须注明是否服从院校内专业调剂（本科提前批B段不设“是否服从院校内专业调剂”选项）。

高校自主招生选拔、高水平艺术团和高水平运动队招生单独设置特殊类型招生志愿，考生可填报1所志愿高校。取得资格认定的考生，须将资格认定高校填报在该志愿中，方能享受相关特殊类型招生政策。

（二）统考统招专科志愿

统考统招专科招生高校按专科提前批、专科普通批两个批次依次录取。专科提前批设置两个顺序志愿，每个志愿填报1所志愿高校，每所志愿高校设置6个志愿专业；专科普通批为平行志愿，设置20个志愿高校，每个志愿高校设置1个志愿专业。

（三）统考统招征集志愿

录取期间，按考生已填报志愿录取结束时，如当前批次高校计划未完成，将根据情况征集考生志愿。

征集志愿设置如下：

本科提前批A段（B、C两段不设置征集志愿）、专科提前批征集志愿设置两个顺序志愿，每个志愿填报1所高校；本科一、二、三批征集志愿均为平行志愿，分别可以填报5所平行志愿高校。以上每个志愿高校设置6个志愿专业。专科普通批征集志愿为平行志愿，设置10个志愿高校，每个志愿高校设置1个志愿专业。考生填报本科各批次征集志愿时须同时注明是否服从院校内专业调剂。

（四）单考单招志愿

单考单招包括职教师资班（本科）招生和高职单考单招。

1、职教师资班招生设置一个志愿，填报1所志愿高校。

2、高职单考单招设置两个顺序志愿，每个志愿填报1所志愿高校。

以上每所志愿高校设置2个志愿专业、1个是否服从院校内专业调剂选项和1个是否愿意走读选项。高职单考单招志愿还包含1个是否愿意调剂到其他学校的选项。

填报职教师资班志愿的考生，必须是中等专业学校、职业高中应届毕业生，否则志愿无效。高职单考单招录取在职教师资班录取结束后进行。

二、志愿填报方式与填报时间

（一）志愿填报方式

（二）志愿填报时间

6月25日8时至29日20时，统考考生填报本科提前批（包含A、B、C三段）志愿、特殊类型招生志愿、本科一批、本科二批、本科三批志愿，单考考生填报职教师资班和高职单考单招志愿。

7月31日8时至8月1日20时，未被录取的统考考生填报专科提前批和专科普通批志愿。

三、投档规则

录取时分本、专科按录取批次顺序进行。本科提前批（包含A、B、C三段）、专科提前批以及单考单招志愿实行顺序志愿投档方式，本科一、二、三批、专科普通批实行平行志愿投档方式。

（一）顺序志愿投档

本科提前批（含A、B、C三段）、专科提前批以及单考单招志愿录取时，实行“志愿优先，从高分到低分”的顺序志愿投档方式，即先进行第一志愿录取，所有高校第一志愿录取结束后，再对未完成计划高校进行第二志愿投档录取。第一、第二志愿投档时对选报同一志愿高校的考生按高校确定的录取原则、调档比例从高分到低分进行投档。

（二）本科平行志愿投档

本科一、二、三批志愿均包含多所志愿高校，实行平行志愿投档方式，按照“分数优先，遵循志愿”的原则进行投档。具体投档办法为：对同一科类类批次线上未被录取的考生按成绩从高分到低分排序进行一次性投档。本科平行投档时根据考生所填报志愿高校顺序，投档到排序在前且有计划余额的高校，分数相同的考生符合同一所高校投档条件且计划余额不足时将依次比较语文、数学（文/理）、外语、文科综合/理科综合科目的.成绩，对单科成绩高者进行投档，直至完成该校招生计划，单科成绩均相同的同时投档。

平行志愿只进行一轮投档，多所高校只作为一个志愿，每个考生最多享受一次投档机会，一旦考生被投档，即使被退档，也不能再投到本轮志愿的其他高校。

（三）专科平行志愿投档

专科普通批志愿包含多所志愿高校，实行平行志愿投档方式，按照“分数优先，遵循志愿”的原则进行投档。具体投档办法为：对同一科类分数线上未被录取的考生按总分（语文、数学、外语三科）从高分到低分排序进行一次性投档。每个考生投档时，根据考生所填报志愿高校专业顺序，投档到排序在前、会考成绩符合要求且有计划余额的高校专业，分数相同的考生符合同一所高校同一专业投档条件且计划余额不足时将依次比较语文、数学（文/理）、外语科目的成绩，对单科成绩高者进行投档，直至完成该高校该专业招生计划，单科成绩均相同的同时投档。专科批次录取采取高会统招形式，即招生高校根据各专业培养需求从会考备选科目中选定2或3门确定成绩等级要求，会考备选科目为：历史、政治、地理、物理、化学、生物、信息技术、通用技术等8门，考生会考成绩必须满足所报专业要求方能投档。

四、志愿填报相关政策说明及注意事项

（一）按照《北京市20xx年普通高等学校招生工作规定》（京招考委〔20xx〕8号）文件规定，少数民族考生，在高考成绩总分的基础上增加5分向高校提供档案，由高校审查决定是否录取，该政策仅适用于北京市属高等学校招生录取。

（二）“双培计划”和“外培计划”分区投放计划，同一高校不同区、科类、专业之间的“双培计划”和“外培计划”不得互调；录取时只录取有专业志愿考生，不进行院校内专业调剂。“农村专项计划”只招收户籍和学籍均在城市发展新区和生态涵养发展区（通州、顺义、大兴、昌平、房山、门头沟、平谷、怀柔、密云、延庆）的农业户口考生。“双培计划”、“外培计划”和“农村专项计划”招生执行本科一批录取最低控制分数线（艺术类、体育类专业分别执行相应类别的本科批次录取最低控制分数线）。

（三）因升学原因将户口迁入我市中专校集体户口的考生：艺术类考生只能报考全国统一招生艺术类专业；体育类考生不参加全市统一志愿填报。

（四）进城务工人员随迁子女只能报考统考专科批次或高职单考单招的志愿。

（五）已被保送生录取、高职自主招生录取、运动训练和武术与民族传统体育专业等单独招生录取的考生，不再参加全市统一志愿填报。

（六）考生要严格按照《20xx年全国普通高等学校在京招生专业目录》填报志愿。在填报之前，要仔细参阅院校的招生章程，了解招生院校的具体要求，结合个人的相关成绩、身体情况认真考虑。如：填报艺术类专业志愿须取得相关艺术类专业考试合格证；填报统考专科志愿时须确认本人会考成绩符合专业要求；填报军事院校（含国防生）、公安院校、武警部队院校等本科提前批录取的专业，须按时参加面试、体检等工作；报考外语类专业、经贸类等相关专业的考生，请查阅招生专业目录了解这些专业对外语口试成绩的要求；填报体育类专业的考生，请确认这些专业对体育专业考试分数的要求等等。

（八）考生须在志愿填报时间截止之前完成信息提交，逾期不予补报。考生志愿是录取的重要依据，志愿填报时间一经截止，任何人不得更改。

代码规范文档(篇五)

1、员工的录工、存档

我入职以后，首先完成了对自己在开发区相关录工手续，并完成存档工作。经过这次人事业务办理，使我很快的熟练掌握三个公司的录工手续，从而进一步完成了多名员工的录工存档业务，在办理录工时，要注意，录工是有时限的，在员工入司30日内办理，同时办理录工时还必须注意，员工是属于集团内哪个公司的，这些是在录工是都是需要注意的问题。

2、员工的退工、退档

退工及退档工作是比较复杂的工作。首先，退工需要准备很多材料，而且根据三个公司注册地不一样，准备的材料也是有区别的，所以在办理退工时理清需要准备的材料。其次退档，要根据员工的户籍地不同，退到员工的户口所在地。退工及退档工作也是有时限的，所以必须在规定的时限内完成退工及退档工作。

3、退休

退休在人事对外业务中是比较重要的一项工作，涉及员工退休后申领退休金及退休后医疗的问题。3月份亚拓物业名下的一名保洁员到了退休年龄，我带着准备好的材料和该名职工在开发区办理退休工作，核定退休金基数，完成退休金申领，保证了员工的退休后应得的利益。

4、劳动合同的初签、续签及备案工作

初签和续签劳动合同一方面是公司合法用工的依据，另一方面也是维护员工的合法权利的准则。根据合同规定内容，公司需要合理用工，而员工需要按照合同内容完成规定工作内容并依据合同内容维护自己的合法权益。在完成合同初签和续签工作后，需要在公司注册地完成用工合同的备案工作，以确保公司用工合法性，为公司用工提供法律保障。

5、保险及公积金缴费

6、员工在开发区生育备案登记工作

生育备案登记涉及员工生育保险待遇支付及申报生育津贴等工作，对员工是一项很重要的福利。我根据开发区关于生育保险业务的经办政策，准备了生育妊娠登记所需要的材料，在开发区社险中心做好了员工的生育妊娠登记，为员工生育后申报生育保险待遇支付及申报生育津贴做好了基础性工作。在办理此项业务时需要注意的是，生育妊娠登记是有时限的，必须在员工确定妊娠10周内完成登记。

7.其他相关人事工作

1）完成部分岗位职责的整理

2）完成入司及退司人员的司内档案整理及归档工作

3）在领导协助下做好每月的员工关系报表整理工作

4）参加各区招聘会

5）协助制作新员工入司培训材料

6）随时关注及学习社会保险相关新政策。

代码规范文档(篇六)

本节的后续部分都将讨论命名规则，这里先提出几项基本命名原则。

较好的命名应该象firstName、grandTotal、CorporateCustomer, 而诸如x1、y1等命名反映任何命名含义，而且造成代码难以理解、维护和改进。

如果软件开发人员应注意软件用户的一些约定术语，不应当随意的创造术语。这会降低软件的易用性。

一般情况下应该用小写字母来命名，其中类（class）和接口（interface）名称的首字母用大写。

设计命名中应该慎用缩写命名。如要采用，则应采用统一的缩略规则，并且在文中的相应部分统一采用缩写。例如，采用num作为number的缩写，那么在整个文档中应该始终使用该缩写。

命名的长度应小于15个字母(但是可以使用更长的形式，以便更好的表达意思)。

命名时应避免采用几乎相同的名称。例如，变量名称persistentObject和persistentObjects不应当同时运用；anSqlDatabase和anSQLDatabase也不应同时使用。

有时名称中会含有固定的缩略词，例如SQL代表Standard Query Language. 而在命名时sqlDatabase和SqlDatabase就比sQLDatabase和SQLDatabase易于阅读。

代码规范文档(篇七)

记得以前的时候我和朋友在周六了海边散步。那是个火热的夏天。

走在路上我热得难受看一下天空哇——！好刺眼哦！蔚蓝的天空悬着火球般的太阳。尽管如此我们还是说着。笑着。

夏天是果子成熟的季节。看在海边旁有好几档小档正在卖新鲜的水果呢！红红的苹果活力的橙子黄澄澄的香蕉应有尽有我都快流口水了呢！

夏天是植物的季节。在海边旁种着一排榕树高大坚固在夏雨过后显得更加碧绿更加着生气勃勃的气势。空气中弥漫着植物和的清香。

我们几个都说着笑着谈一谈有趣的事情都说夏天天气好阳光明媚空气清新。说着我吸了一大口空气感到神清气爽整个人舒服多了！

成群结队的鸟儿在天空中自由地飞看来它们也非常喜欢夏天这个多变的季节。

这真是个美好的星期六！我们都感到心情开心了。

代码规范文档(篇八)

对于较复杂的类或方法，最好在其注释文档中增加一段如何使用本类（方法）的例子代码。由于javadoc生成的文档会忽略空格和换行，应在样例代码段前后加上<pre></pre>标签：

下面给出一个简单的批处理文件用于生成javadoc文档：

另外，Javadoc 有许多有用的选项，有些相对其他更为常用。下面是实际中我们用来在 Java 平台 API 上运行 javadoc 的命令，它使用了 makefile 变量（除了未列出所有要建文档的包之外）。

如果省略 -windowtitle 选项，则 javadoc 将文档标题复制到窗口标题。-windowtitle 选项是没有必要的，除非文档标题包含 HTML 标记。

代码规范文档(篇九)

通常Java源文件中第一个非注释行是一个Package声明，然后是Import声明。如下所示。

package ;

import ;

类和接口声明

下表描述了类和接口声明中的一些部分，按照其出现顺序列出：

类和接口说明

说明

Class/Interface 文档型注释

/**

*

*/

Class或Interface声明

Class或Interface的实现声明

该段注释中应该包括任何与类和接口有关的，但又不适于放在文档注释区中的注释说明

类静态变量

变量出现的顺序为，首先公共变量，然后protected变量，然后是包package一级的变量，然后是私有变量

变量实例

首先是公共变量，然后protected变量，然后是包package一级的变量，然后是私有变量

构造函数（Constructors）

方法

方法应该按照功能而不是范围和可访问性来分类。例如，一个私有的类方法可以在两个公共的Instance方法的中间。这样做的目的是提高代码的可读性。

文档的缩进规则

文档中的缩进基本单位是4个空格。Tab键应当设置为4个空格键(WSAD中的缺省设置)。

代码规范文档(篇十)

命名

关于EJB的命名在《Java编程规范(平台科)》中提到：

Remote接口：。

这样的命名，在Jbuilder7中存在“警告信息”，它认为JavaIDL路径名和类

名重复可能会导致CORBA访问的问题。

所以，建议Remote接口如下命名：

Remote接口：。

Web发布目录移植(websphereweblogic)

绝对不要把websphere的和文件放在weblogic

的发布目录下。这将导致莫名其妙的错误，使得weblogic以为XML的配置文件已经更

Jbuilder7在win2000中的问题

注意在系统环境中更改temp目录，因为Jbuilder7在编译EJB是会到登录用户的

临时目录下交换文件。而缺省的目录却是C:\Documents and Settings\loginuser\Local

Settings\Temp，在路径中存在空格导致EJB在Weblogic下无法通过Jbuilder的IDE环境编译打包。

还有Jbuilder7中，需要在WebLogic Client和WebLogic Deploy的类

库中加入JDK的运行包。否则，编译EJB时它根本就找不到类。

性能问题

我们知道每个新的JSP文件在没有编译时，一旦要使用它，Servlet Engineer会在

第一次使用时编译它。这时，你会感觉页面有停滞。在Websphere中这种停滞太大了，

在Weblogic中几乎没什么感觉。不知道是不是因为websphere仅仅是WSAD中的测试环

境而不是一个真正的产品。如果不是仅仅因为这个，那么就太失望了。

一：不允许使用汉语拼音命名 欠规范代码示例： public void zengJiaYongHu(){} 拼音方法名称 规范代码示例: public void addUser(){} 解析：应当使用国际化语言，拼音使得代码难懂 二：Package名必须全部小写，尽量使用单个单词 欠规范代码示例： 单词大写了,daoImpl多个单词 规范代码示例: 解析：这是一个大家都认同的习惯写法，也是一个默认的规范 三：局部变量及输入参数不要与类成员变量同名(get/set方法与构造函数除外) 欠规范代码示例： public class UserDAOImpl{ private int count; pubic void page(int count){} } 类字段和方法参数名相同 规范代码示例: public class UserDAOImpl{ private int count; pubic void page(int pageCount){} } 解析：类变量会引起逻辑错误，引起覆盖。 四：尽量不要在变量后面加魔法数字,英文单个字母和没有实际意义的英文数字单词来区分变量 欠规范代码示例： String One; 命名一个英文数字的变量 User user1 = new User(); User user2 = new User(); 规范代码示例: User userAdd = new User(); User userUpdate = new User(); 解析：这样会降低代码的可读性，并且不容易日后开发人员的维护 文字数限制的原因，未完。。。

注：代码中必须要有注释！

代码规范文档(篇十一)

尊敬的各位领导：

作为xx组件技术部的一名技术主管，我在工作过程中严重失职，在生产限额领料单中添加了错误的铝合金边框代码，造成交付给客户的组件边无法安装，给公司信誉造成了无法挽回的损失。在此我表示深深的歉意并递交这份工作失职检讨书向各位领导做出深刻反省和自查。

由于我的工作岗位关系到整个生产订单所使用的物料正确与否，长期以来对自己放松要求，工作作风涣散，无视公司的审批报告流程，最终导致这次严重的质量事故发生，辜负了领导的信任，也损害了公司的信誉。通过这件事，暴露出我个人存在严重的工作松懈问题，以及工作态度不端正，做事情不严谨等不良工作作风。为杜绝今后再犯同样的错误，以此次检讨为契机，深入审视和纠正自身工作中存在的问题：

首先，我作为部门文件的管理者，对于部门文件的管理不严谨，文件没有固定的存放地点，通常是谁想看文件谁拿去看，看完就随手一扔，每当遇到问题想要翻阅时却找不到文件在哪。本次事故就是一个深刻的教训，由于文件是10月份下发而添加错误边框的订单是xx月的生产订单，在核对物料编码时没有查找相关的工作联系单是导致此次事故的一个重要原因。

其次是认识上的问题，总是认为自己是文件的发放者，而别人才是文件的执行者，通常是一扫而过，只理解了文件的表面内容，而忽略了文件所要传递的重要信息。本次事故中，由于之前阅读文件是草草掠过，导致大脑中只记住了4孔边框和6孔边框均可使用并且不得混用于同一个组件，但是却没有记住4孔边框有两种不同孔距的物料代码，正确的代码应该为M510103，而自己却添加了错误的代码M510xx0。

第三是态度上的问题，由于平时领导对我的工作十分信任，因此自己经常不按照规定的流程开展工作，私自做决定，私自更改物料。如果此次添加物料代码时先向部门领导进行请示，就可以避免错误的物料代码被使用，从而也就不会造成如此严重的后果。

为了杜绝今后再次出现类似的错误，我将从以下几个方面来纠正和预防：

第一，严格落实物料添加的审批流程，在每次添加或者变更物料时，都随限额单附加一份物料变更通知单，如附件一所示。在该通知单中详细写明变更或者添加的物料名称及物料代码，然后交由部门主管审核批准，再交由各相关部门会签后随限额领料单一并下发给相关部门。

第二，在装框工段首末三检卡中增加边框孔数量，孔间距的检验要求，如附件二所示。每日生产前以及每次物料切换时都使用此三检卡对物料进行确认。并在每次生产技术准备文件(工艺联络书-订单生产注意事项)中加入边框孔距示意图，作为装框工段三检卡确认以及巡检、外观检验的检查确认的依据。

第三，规范部门文件的管理，每一份新发放的文件都传阅给相关人员进行阅读并签字，阅读完后统一存档保管，并做好文件目录和收发台账，方便随时查阅。

通过这件事我重新反思了自己做人、做事的态度，感悟到：做人要专注，做事也要专注。做事情不专注，就无法清楚的把握细节，就一定无法把事情做得圆满。从今天起对自己严格要求，严肃自身工作态度，强化自身岗位责任感，克服思想涣散等坏毛病，不能再容忍任何的马虎和“差不多”心里，铭记自身工作的重要性，认真履行自己的岗位职责，以加倍努力的工作来弥补自己所犯的错误。

代码规范文档(篇十二)

1、eclipse code formatter

2、JavadDoc

3、JUnitGenerator

Rule 1. 【强制】避免成员变量，方法参数，局部变量重名复写，避免引起混淆

类的私有成员变量名，不与父类的成员变量重名

方法的参数名/局部变量名，不与类的成员变量重名(getter/setter例外)

下面错误的地方，在编译时都是合法的，但给阅读者带来极大的障碍。

Rule 1. 【强制】使用项目组统一的代码格式模板，基于IDE自动的格式化 基于阿里P3C插件，也可以安装阿里的模板，建议统一 10）IDE的默认代码格式模板，能简化绝大部分关于格式规范(如空格，括号)的描述。

2）统一的模板避免不同开发者之间，因为格式不统一，产生代码合并冲突。另外，代码变更日志中因为格式不同引起的变更，也会掩盖了真正的逻辑变更。

3）设定项目组统一的行宽，建议120。

4）设定项目组统一的缩进方式(Tab或二空格，四空格均可)，基于IDE自动转换。

Rule 2. 【推荐】通过空行进行逻辑分段

一段代码也是一段文章，需要合理的分段。

不同组的变量之间，不同业务逻辑的代码行之间，插入一个空行，起逻辑分段的作用。

而联系紧密的变量之间、语句之间，则尽量不要插入空行。

Rule 3.【推荐】避免IDE格式化

对于一些特殊场景（如使用大量的字符串拼接成一段文字，或者想把大量的枚举值排成一列），为了避免IDE自动格式化，常常会把注释符号//加在每一行的末尾，这会导致很多无意义的视觉干扰。

可以使用@formatter:off和@formatter:on来包装这段不需要格式化的代码，让IDE就会跳过这段的格式化。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-YNJfoIh9-1624848159255)(C:\Users\86134\AppData\Roaming\Typora\typora-user-images\)]

Rule 1.【推荐】基本的注释要求

代码将被大量后续维护，注释如果对阅读者有帮助，不要吝啬在注释上花费的时间。

除了特别简单特别清晰的类（见规则2，3），每个类都尽量编写注释，说明类的目的和使用方法。

对外提供的公有方法，同样需要清晰的描述，期待的输入，对应的输出，错误的处理和返回码，尽量把可能的异常都一一列明。

Rule 2. 【推荐】通过更清晰的代码来避免注释

在编写注释前，考虑是否可以通过更好的命名，更清晰的代码结构，更好的函数和变量的抽取，让代码不言自明，此时不需要额外的注释。

Rule 3. 【推荐】删除空注释，无意义注释

《Clean Code》建议，如果没有想说的，不要留着IDE自动生成的，空的@param，@return，@throws 标记，让代码更简洁。

反例：方法名为put，加上两个有意义的变量名elephant和fridge，已经说明了这是在干什么，不需要任何额外的注释。

Rule 4.【推荐】避免创建人，创建日期，及更新日志的注释

代码后续还会有多人多次维护，让我们相信源码版本控制系统能做得更好。

Rule 5. 【强制】代码修改的同时，注释也要进行相应的修改。尤其是参数、返回值、异常、核心逻辑等的修改

Rule 6. 【强制】类、类成员变量、类方法的注释必须使用Javadoc规范，使用/**xxx*/格式，不得使用//xxx方式

正确的JavaDoc格式可以用在很多地方，比如在IDE中，查看调用方法时，不进入方法即可悬浮提示方法、参数、返回值的意义，提高阅读效率。

Rule 7. 【推荐】JavaDoc中不要为了HTML格式化而大量使用HTML标签和转义字符

如果为了HTML版JavaDoc的显示，大量使用<p\> <pre\>这样的html标签，以及&lt &quot 这样的html转义字符，对严重影响直接阅读代码时的直观性，而直接阅读代码的几率其实比看Html版JavaDoc大得多。

有时候Java Doc的格式化也要求<p>之类的标签来换行，可以配置让IDE不进行Java Doc的自动格式化。

Rule 8. 【推荐】TODO标记，清晰说明代办事项和处理人

清晰描述待修改的事项，保证过几个月后仍然能够清楚要做什么修改。

如果近期会处理的事项，写明处理人。

通过标记扫描，经常清理此类标记，线上故障经常来源于这些标记但未处理的代码。

Rule 9. 【推荐】合理处理注释掉的代码

如果后续会恢复此段代码，在目标代码上方用///注释详细说明，而不是简单的注释掉。

如果无用，则直接删除（版本管理工具保存了历史代码）。

Rule 1. 【推荐】方法的长度度量

方法尽量不要超过100行，或其他团队共同商定的行数。华为是50，但是对于大一些的业务和注解较多的情况，感觉80较为合理

另外，方法长度超过8000个字节码时，将不会被JIT编译成二进制码。

Rule 2. 【推荐】方法的语句在同一个抽象层级上

反例：一个方法里，前20行代码在进行很复杂的基本价格计算，然后调用一个折扣计算函数，再调用一个赠品计算函数。

此时可将前20行也封装成一个价格计算函数，使整个方法在同一抽象层级上。

Rule 3. 【推荐】为了帮助阅读及方法内联，将小概率发生的异常处理及其他极小概率进入的代码路径，封装成独立的方法

Rule 4. 【推荐】尽量减少重复的代码，抽取方法

超过5行以上重复的代码，都可以考虑抽取公用的方法。

Rule 5. 【推荐】方法参数最好不超过3个，最多不超过7个

1）如果多个参数同属于一个对象，直接传递对象。

例外: 你不希望依赖整个对象，传播了类之间的依赖性。

2）将多个参数合并为一个新创建的逻辑对象。

例外: 多个参数之间毫无逻辑关联。

3）将函数拆分成多个函数，让每个函数所需的参数减少。

Rule 6.【推荐】下列情形，需要进行参数校验

1） 调用频次低的方法。

2） 执行时间开销很大的方法。此情形中，参数校验时间几乎可以忽略不计，但如果因为参数错误导致中间执行回退，或者错误，代价更大。

3） 需要极高稳定性和可用性的方法。

4） 对外提供的开放接口，不管是RPC/HTTP/公共类库的API接口。

如果使用Apache Validate 或 Guava Precondition进行校验，并附加错误提示信息时，注意不要每次校验都做一次字符串拼接。

Rule 7.【推荐】下列情形，不需要进行参数校验

1） 极有可能被循环调用的方法。

2） 底层调用频度比较高的方法。毕竟是像纯净水过滤的最后一道，参数错误不太可能到底层才会暴露问题。

比如，一般DAO层与Service层都在同一个应用中，所以DAO层的参数校验，可以省略。

3） 被声明成private，或其他只会被自己代码所调用的方法，如果能够确定在调用方已经做过检查，或者肯定不会有问题则可省略。

即使忽略检查，也尽量在方法说明里注明参数的要求，比如vjkit中的@NotNull，@Nullable标识。

Rule 8.【推荐】禁用assert做参数校验

看到代码中比较多，可以商议

assert断言仅用于测试环境调试，无需在生产环境时进行的校验。因为它需要增加-ea启动参数才会被执行。而且校验失败会抛出一个AssertionError(属于Error，需要捕获Throwable）

因此在生产环境进行的校验，需要使用Apache Commons Lang的Validate或Guava的Precondition。

Rule 9.【推荐】返回值可以为Null，可以考虑使用JDK8的Optional类

不强制返回空集合，或者空对象。但需要添加注释充分说明什么情况下会返回null值。

本手册明确防止NPE是调用者的责任。即使被调用方法返回空集合或者空对象，对调用者来说，也并非高枕无忧，必须考虑到远程调用失败、序列化失败、运行时异常等场景返回null的情况。

JDK8的Optional类的使用这里不展开。

Rule 10.【推荐】返回值可以为内部数组和集合

如果觉得被外部修改的可能性不大，或没有影响时，不强制在返回前包裹成Immutable集合，或进行数组克隆。

Rule 11.【推荐】不能使用有继承关系的参数类型来重载方法

因为方法重载的参数类型是根据编译时表面类型匹配的，不根据运行时的实际类型匹配。

Rule 12.【强制】正被外部调用的接口，不允许修改方法签名，避免对接口的调用方产生影响

只能新增新接口，并对已过时接口加@Deprecated注解，并清晰地说明新接口是什么。

Rule 13.【推荐】不使用@Deprecated的类或方法

接口提供方既然明确是过时接口并提供新接口，那么作为调用方来说，有义务去考证过时方法的新实现是什么。

比如 中的方法decode(String encodeStr) 这个方法已经过时，应该使用双参数decode(String source, String encode)。

Rule 14.【推荐】不使用不稳定方法，如.*包下的类，底层类库中internal包下的类

.*，sun.*包下的类，或者底层类库中名称为internal的包下的类，都是不对外暴露的，可随时被改变的不稳定类。

Rule 1.【推荐】 减少类之间的依赖

比如如果A类只依赖B类的某个属性，在构造函数和方法参数中，只传入该属性。让阅读者知道，A类只依赖了B类的这个属性，而不依赖其他属性，也不会调用B类的任何方法。

Rule 2. 【推荐】类的长度度量

类尽量不要超过300行，或其他团队共同商定的行数。华为是2000，可以商议

对过大的类进行分拆时，可考虑其内聚性，即类的属性与类的方法的关联程度，如果有些属性没有被大部分的方法使用，其内聚性是低的。

Rule 1. 【强制】if, else, for, do, while语句必须使用大括号，即使只有单条语句

曾经试过合并代码时，因为没加括号，单条语句合并成两条语句后，仍然认为只有单条语句，另一条语句在循环外执行。

其他增加调试语句等情况也经常引起同样错误。

可在IDE的Save Action中配置自动添加。

例外：一般由IDE生成的equals()函数

Rule 2.【推荐】少用if-else方式，多用哨兵语句式以减少嵌套层次

Rule 3.【推荐】限定方法的嵌套层次

所有if/else/for/while/try的嵌套，当层次过多时，将引起巨大的阅读障碍，因此一般推荐嵌套层次不超过4。 华为是5，方法大小，类大小，嵌套深度和圈复杂度等代码复杂度分析也是一种很重要的手段

通过抽取方法，或哨兵语句（见Rule 2）来减少嵌套。

Rule 4.【推荐】布尔表达式中的布尔运算符(&&,||)的个数不超过4个，将复杂逻辑判断的结果赋值给一个有意义的布尔变量名，以提高可读性

Rule 5.【推荐】简单逻辑，善用三元运算符，减少if-else语句的编写

Rule 6.【推荐】减少使用取反的逻辑

不使用取反的逻辑，有利于快速理解。且大部分情况，取反逻辑存在对应的正向逻辑写法。

Rule 7.【推荐】表达式中，能造成短路概率较大的逻辑尽量放前面，使得后面的判断可以免于执行

Rule 8.【强制】switch的规则

1）在一个switch块内，每个case要么通过break/return等来终止，要么注释说明程序将继续执行到哪一个case为止；

2）在一个switch块内，都必须包含一个default语句并且放在最后，即使它什么代码也没有。

Rule 9.【推荐】循环体中的语句要考量性能，操作尽量移至循环体外处理

1）不必要的耗时较大的对象构造；

2）不必要的try-catch（除非出错时需要循环下去）。

Rule 10.【推荐】能用while循环实现的代码，就不用do-while循环

while语句能在循环开始的时候就看到循环条件，便于帮助理解循环内的代码；

do-while语句要在循环最后才看到循环条件，不利于代码维护，代码逻辑容易出错。

Rule 1. 字符串拼接的原则

【推荐】 当字符串拼接不在一个命令行内写完，而是存在多次拼接时(比如循环)，使用StringBuilder的append()

反编译出的字节码文件显示，其实每条用+进行字符拼接的语句，都会new出一个StringBuilder对象，然后进行append操作，最后通过toString方法返回String对象。所以上面两个错误例子，会重复构造StringBuilder，重复toString()造成资源浪费。

【强制】 字符串拼接对象时，不要显式调用对象的toString()

如上，+实际是StringBuilder，本身会调用对象的toString()，且能很好的处理null的情况。

【强制】使用StringBuilder，而不是有所有方法都有同步修饰符的StringBuffer

因为内联不成功，逃逸分析并不能抹除StringBuffer上的同步修饰符

【推荐】当拼接后字符串的长度远大于16时，指定StringBuilder的大概长度，避免容量不足时的成倍扩展

【推荐】如果字符串长度很大且频繁拼接，可考虑ThreadLocal重用StringBuilder对象

参考BigDecimal的toString()实现，及vjkit中的StringBuilderHolder。

Rule 2. 【推荐】字符操作时，优先使用字符参数，而不是字符串，能提升性能

没用过，所以摘出来了

其他包括split等方法，在JDK String中未提供针对字符参数的方法，可考虑使用Apache Commons StringUtils 或Guava的Splitter。

Rule 1. 【推荐】底层数据结构是数组的集合，指定集合初始大小

底层数据结构为数组的集合包括 ArrayList，HashMap，HashSet，ArrayDequeue等。

数组有大小限制，当超过容量时，需要进行复制式扩容，新申请一个是原来容量150% or 200%的数组，将原来的内容复制过去，同时浪费了内存与性能。HashMap/HashSet的扩容，还需要所有键值对重新落位，消耗更大。

默认构造函数使用默认的数组大小，比如ArrayList默认大小为10，HashMap为16。因此建议使用ArrayList(int initialCapacity)等构造函数，明确初始化大小。

HashMap/HashSet的初始值还要考虑加载因子:

为了降低哈希冲突的概率(Key的哈希值按数组大小取模后，如果落在同一个数组下标上，将组成一条需要遍历的Entry链)，默认当HashMap中的键值对达到数组大小的75%时，即会触发扩容。因此，如果预估容量是100，即需要设定100/＝134的数组大小。vjkit的MapUtil的Map创建函数封装了该计算。

如果希望加快Key查找的时间，还可以进一步降低加载因子，加大初始大小，以降低哈希冲突的概率。

Rule 2. 【推荐】尽量使用新式的foreach语法遍历Collection与数组

foreach是语法糖，遍历集合的实际字节码等价于基于Iterator的循环。

foreach代码一来代码简洁，二来有效避免了有多个循环或嵌套循环时，因为不小心的复制粘贴，用错了iterator或循环计数器(i,j)的情况。

Rule 3. 【强制】不要在foreach循环里进行元素的remove/add操作，remove元素可使用Iterator方式

Rule 4. 【强制】使用entrySet遍历Map类集合Key/Value，而不是keySet 方式进行遍历

keySet遍历的方式，增加了N次用key获取value的查询。

Rule 5. 【强制】当对象用于集合时，下列情况需要重新实现hashCode()和 equals()

1） 以对象做为Map的KEY时；

2） 将对象存入Set时。

上述两种情况，都需要使用hashCode和equals比较对象，默认的实现会比较是否同一个对象（对象的引用相等）。

另外，对象放入集合后，会影响hashCode()，equals()结果的属性，将不允许修改。

Rule 6. 【强制】高度注意各种Map类集合Key/Value能不能存储null值的情况

由于HashMap的干扰，很多人认为ConcurrentHashMap是可以置入null值。同理，Set中的value实际是Map中的key。

Rule 7. 【强制】长生命周期的集合，里面内容需要及时清理，避免内存泄漏

长生命周期集合包括下面情况，都要小心处理。

1） 静态属性定义；

2） 长生命周期对象的属性；

3） 保存在ThreadLocal中的集合。

如无法保证集合的大小是有限的，使用合适的缓存方案代替直接使用HashMap。

另外，如果使用WeakHashMap保存对象，当对象本身失效时，就不会因为它在集合中存在引用而阻止回收。但JDK的WeakHashMap并不支持并发版本，如果需要并发可使用Guava Cache的实现。

Rule 8. 【强制】集合如果存在并发修改的场景，需要使用线程安全的版本

推荐使用(JUC)工具包中的并发版集合，如ConcurrentHashMap等，优于使用()系列函数进行同步化封装(等价于在每个方法都加上synchronized关键字)。

例外：ArrayList所对应的CopyOnWriteArrayList，每次更新时都会复制整个数组，只适合于读多写很少的场景。如果频繁写入，可能退化为使用(list)。

例如：即使用了ConcurrentHashMap，但直接是用get/put方法，仍然可能会多线程间互相覆盖。

Rule 9. 【推荐】正确使用集合泛型的通配符

List<String>并不是List<Object>的子类，如果希望泛型的集合能向上向下兼容转型，而不仅仅适配唯一类，则需定义通配符，可以按需要extends 和 super的字面意义，也可以遵循PECS(Producer Extends Consumer Super)原则:

Rule 10. 【推荐】List, List<?> 与 List<Object>的选择

定义成List，会被IDE提示需要定义泛型。 如果实在无法确定泛型，就仓促定义成List<?>来蒙混过关的话，该list只能读，不能增改。定义成List<Object>呢，如规则10所述，List<String> 并不是List<Object>的子类，除非函数定义使用了通配符。

因此实在无法明确其泛型时，使用List也是可以的。

Rule 11. 【推荐】如果Key只有有限的可选值，先将Key封装成Enum，并使用EnumMap

没用过，所以摘出来了

EnumMap，以Enum为Key的Map，内部存储结构为Object[]，访问时以value = Object[()]获取值，同时具备HashMap的清晰结构与数组的性能。

Rule 12. 【推荐】Array 与 List互转的正确写法

(array)，如果array是原始类型数组如int[]，会把整个array当作List的一个元素，String[] 或 Foo[]则无此问题，安全起见统一不使用。

Rule 1. 【强制】创建线程或线程池时请指定有意义的线程名称，方便出错时回溯

这个还是挺重要的，尤其是在自定义线程池中

1）创建单条线程时直接指定线程名称

2） 线程池则使用guava或自行封装的ThreadFactory，指定命名规则。

Rule 1. 【强制】创建异常的消耗大，只用在真正异常的场景

上份工作有点滥用异常捕获，归根结底是代码坏味道

构造异常时，需要获得整个调用栈，有一定消耗。

不要用来做流程控制，条件控制，因为异常的处理效率比条件判断低。

发生概率较高的条件，应该先进行检查规避，比如：IndexOutOfBoundsException，NullPointerException等，所以如果代码里捕获这些异常通常是个坏味道。

Rule 2. 【推荐】异常日志应包含排查问题的足够信息

很重要，要打印出重要信息才能还原生产问题出现的场景，处理生产问题时，日志是很重要的参考手段

异常信息应包含排查问题时足够的上下文信息。

捕获异常并记录异常日志的地方，同样需要记录没有包含在异常信息中，而排查问题需要的信息，比如捕获处的上下文信息。

Rule 3. 异常抛出的原则

【推荐】尽量使用JDK标准异常，项目标准异常

尽量使用JDK标准的Runtime异常如IllegalArgumentException，IllegalStateException，UnsupportedOperationException，项目定义的Exception如ServiceException。

【推荐】根据调用者的需要来定义异常类，直接使用RuntimeException是允许的

是否定义独立的异常类，关键是调用者会如何处理这个异常，如果没有需要特别的处理，直接抛出RuntimeException也是允许的。

Rule 4. 异常捕获的原则

【推荐】按需要捕获异常，捕获Exception或Throwable是允许的

如果无特殊处理逻辑，统一捕获Exception统一处理是允许的。

捕获Throwable是为了捕获Error类异常，包括其实无法处理的OOM StackOverflow ThreadDeath，以及类加载，反射时可能抛出的NoSuchMethodError NoClassDefFoundError等。

【推荐】多个异常的处理逻辑一致时，使用JDK7的语法避免重复代码**

Rule 5.异常处理的原则

【强制】捕获异常一定要处理；如果故意捕获并忽略异常，须要注释写明原因

方便后面的阅读者知道，此处不是漏了处理。

【强制】异常处理不能吞掉原异常，要么在日志打印，要么在重新抛出的异常里包含原异常

【强制】如果不想处理异常，可以不进行捕获。但最外层的业务使用者，必须处理异常，将其转化为用户可以理解的内容

Rule 6. finally块的处理原则

因为finally语句块的特殊性，确实会出现问题，之前没注意

【强制】必须对资源对象、流对象进行关闭，或使用语法try-with-resource

关闭动作必需放在finally块，不能放在try块 或 catch块，这是经典的错误。

更加推荐直接使用JDK7的try-with-resource语法自动关闭Closeable的资源，无需在finally块处理，避免潜在问题。

【强制】如果处理过程中有抛出异常的可能，也要做try-catch，否则finally块中抛出的异常，将代替try块中抛出的异常

【强制】不能在finally块中使用return，finally块中的return将代替try块中的return及throw Exception

Rule 1. 【强制】应用中不可直接使用日志库（Log4j、Logback）中的API，而应使用日志框架SLF4J中的API

使用门面模式的日志框架，有利于维护各个类的日志处理方式统一。

Rule 6. 【强制】禁止配置日志框架输出日志打印处的类名，方法名及行号的信息

之前不知道，可以作为参考

日志框架在每次打印时，通过主动获得当前线程的StackTrace来获取上述信息的消耗非常大，尽量通过Logger名本身给出足够信息。

Rule 7. 【推荐】谨慎地记录日志，避免大量输出无效日志，信息不全的日志

是的，尤其是在公共类中，不要JSON工具类对整个对象进行打印，尤其是循环中，非常耗费性能

大量地输出无效日志，不利于系统性能，也不利于快速定位错误点。

记录日志时请思考：这些日志真的有人看吗？看到这条日志你能做什么？能不能给问题排查带来好处？

Rule 1. 【参考】尽量不要让魔法值（即未经定义的数字或字符串常量）直接出现在代码中

例外：-1,0,1,2,3 不认为是魔法数

-1，0，1 作为正负数等判断或其他流程控制场景时，是否需要定义为常量，有待商榷

代码规范文档(篇十三)

普通高中招生

合理确定普通高中招生规模

各县市区教育局要按照高中阶段毛入学率达到91%以上的目标要求，充分考虑课程改革和高考改革对学校教育资源配置的要求，综合分析初中应届毕业生源状况，以及民办学校等跨区域招生、户籍地生源回流等因素，确定各普通高中办学规模。

主要参考依据是：符合教育行政部门批准的办学规模和学校发展规划;学校生均校舍建筑面积不低于8平方米/生(不含师生生活用房);在校学生与专任教师比例不高于;班额不超过56人。2019年秋季招生计划按招生计划班级与可供教室原则上不低于倍比例确定。

普通高中学校须按时向所属教育行政部门提出招生计划申请，所属教育行政部门在对申请招生计划学校的办学条件、教育教学质量、规范办学行为以及上年度实际招生情况等进行综合评判的基础上，科学确定所属普通高中学校招生计划，并报市教育局审批。全市普通高中招生计划另文下达。

进一步规范招生范围

普通高中招生工作实行市级统筹。市直属高中面向全市招生;区属公办普通高中可跨阜城三区招生;其它各县市属公办普通高中在本县域内招生;全市所有公办普通高中不得跨省辖市招生。

未经市教育局批准，公办普通高中不得跨县域招生。各民办普通高中招生应由属地教育行政部门依据民办学校办学规模合理划定招生范围，以学校所在地生源为主，享有与公办普通高中学校同等的招生权利，并与公办普通高中学校同步招生，不得提前招生。

民办普通高中跨省辖市招生的，应向社会公告经批准的年度总招生计划和跨省辖市招生计划，并按计划招生。公办、民办普通高中均不得录取未参加初中学业水平考试、未达到普通高中录取最低控制分数线、未填报普高志愿的学生。同城范围内(含县域内)的普通高中学生严禁借读。坚决制止违规跨区域争抢生源、“掐尖”招生行为。各地要加强对民办普通高中招生的指导和监管，没有取得办学许可证的民办普通高中(含筹设期间)不得参与招生。

初中综合素质评价

现在校就读九年级学生的综合素质评价的具体操作方式仍按照《关于印发2011年阜阳市初中毕业和高中招生制度改革实施方案》(阜教基〔2011〕9号)执行。在外地就读的我市户籍应届初中毕业生，由学籍所在学校提供综合素质评价结果并加盖当地县市区教育局公章，报户籍所在县市区教育局审核。

6月6日前，各县市区教育局上报考生综合素质评价结果。评价结果作为普通高中学校招生录取的限定性条件。

根据省教育厅《初中学生综合素质评价实施办法》和《初中学生综合素质评价工作指南》要求，从2017年秋季入学的七年级学生开始全面推行，从道德与法治、学业水平、身心健康、艺术素养和社会实践五个方面客观记录学生成长过程中全面发展情况和个性特长。通过安徽基础教育资源应用平台学生空间“成长记录系统”建立学生综合素质评价档案，常态化开展学生综合素质评价工作，结果以纪实报告呈现。

普通高中录取

招生对象

2019年全市普通高中招生对象为2019届初中毕业生和未被普通高中阶段学校录取的往届初中毕业生。随迁子女在我市流入地参加初中学业水平考试和报考普通高中学校，与当地学生执行相同的普通高中招生政策。异地就读的回我市户籍所在地参加普通高中阶段学校招考录取的学生，享受与户籍所在地考生同等政策待遇，各地不得拒绝招考和录取。

录取批次

第一批次为特长生录取批次。考生不需要填报志愿，按照考生专业考核成绩由高到低择优录取，未完成的计划调回该校统招生计划。第二批次，省级示范高中招生;先录取统招生，后录取指标到校生;第三批次：普通高中(含市示范高中、民办高中)招生。

志愿填报

录取原则及办法

本市户籍的学生在市外参加中考要求回原籍录取的，可持考生准考证、中考所在地市教育局提供的考生分数证明及中考总分证明，到户籍所在地县级教育行政部门进行分数折算，由户籍所在地县级教育行政部门负责录入志愿信息，进行录取。省内回籍生需要达到中考所在地最低录取控制分数线方可折算。

普高指标到校生政策

强化普通高中指标到校生政策导向。2019年省示范高中指标到校生比例不得低于80%，按志愿从高分到低分依次录取，不得设置省示范高中指标到校生最低录取控制线(但须达到普高招生录取最低控制分数线，若未达到普高招生录取最低控制分数线，所剩指标将面向所有考生按照志愿从高分到低分依次补录)。

省示范高中到校指标原则上根据各初中实际在籍、就读满三年且报名参加初中学业水平考试的毕业年级学生数，按比例切块分配，严禁将指标分配与初中升学率挂钩。指标到校生在各县市区教育局的统筹指导下继续执行义务教育法和义务教育入学政策规定。对于各地出现的诸如农业转移人口等政策性特殊情况，由县级教育行政部门结合本地实际做出具体规定，报经当地政府同意后实施。

市直属省级示范普通高中到校指标由市教育局分解到各初中学校。各县市区属省级示范普通高中到校指标由所在地教育局负责分配。鼓励有条件的县市区实行100%的指标分解。鼓励和支持辖区内示范高中联合招生。对2018年因办学行为、招生入学等违规被各级教育主管部门通报的初中学校，调减或取消分配指标。

普高录取最低分数控制线

颍上县、阜南县、临泉县、太和县及界首市普通高中录取最低分数控制线由各地教育行政部门根据本地实际情况自行划定，并报市教育局备案。

颍东区、颍泉区、颍州区普通高中录取最低分数控制线由市教育局协调三区教育局统一划定。普通高中录取最低分数控制线含体育与健康和理科实验操作考试成绩。

补录计划

根据录取情况，市教育局将及时公布普通高中学校补录计划，未录取的达线考生可参加补录。

考生可凭准考证、成绩通知单到初中毕业学校所在县市区指定的补录志愿填报点进行补录志愿填报。招生计划已完成的学校和已被高中学校录取的考生，一律不得参加补录。

这点要注意

参加中考并被录取的考生，应在规定的时间持录取通知书到学校报到并办理入学相关手续，在规定的时间内未报到且未向录取学校说明原因的视为放弃就读机会，其它任何普通高中学校不得录取。

中考政策加分对象和标准

(1)根据《安徽省实施〈xxx归侨侨眷权益保护法〉办法》，归侨、归侨子女和华侨在国内的子女考生，在其中考成绩基础上增加10分投档;其他侨眷，在本省定居的港澳同胞及港澳同胞、外籍华人在本省的眷属考生，在其中考成绩基础上增加5分投档。

(2)台湾籍考生在其中考成绩基础上增加10分投档。

(3)烈士子女在其中考成绩基础上增加10分投档。

(4)少数民族考生在其中考成绩基础上增加5分投档。

(5)援疆和援藏人员子女在其中考成绩基础上增加10分投档。

(6)军人子女考生加分。驻国家确定的三类(含三类)以上艰苦边远地区和西藏自治区，解放军总部划定的二类(含二类)以上驻岛屿部队军人的子女，在飞行、潜艇、航天、涉核等高风险、高危害岗位工作的军人的子女，在其中考成绩基础上增加20分投档。作战部队、在驻国家确定的一类、二类艰苦边远地区和解放军总部划定的三类岛屿部队军人的子女，一级至四级残疾军人的子女，平时荣获二等功或战时荣获三等功以上奖励的军人的子女，在其中考成绩的基础上增加10分投档。

(7)公安英烈和因公牺牲伤残警察子女考生加分。公安系统烈士子女可在其中考成绩基础上增加10分投档。公安系统一级、二级英雄模范子女和公安系统因公牺牲民警子女以及一级至四级因公伤残民警子女增加5分投档。

(8)国家综合性消防救援队伍人员子女考生加分参照《安徽省应急管理厅安徽省教育厅关于切实做好国家综合性消防救援队伍人员及其子女教育优待工作的通知》(皖应急〔2019〕61号)规定执行。

同时符合多项加分条件的考生，只能享受其中最高的一项，不累计加分。

学生学籍管理

严格执行《安徽省教育厅关于进一步明确中小学学籍信息化管理有关事项的通知》(皖教秘基〔2017〕117号)有关要求，严格执行“籍随人走、人籍一致”原则，学生没有到校报到入学的，学校不得将其学籍注册成正式在校生;严禁出现人籍分离、空挂学籍、学籍造假等现象，不得为违规跨区域招收的学生和违规转学学生办理学籍转接。

对因违反招生规定而产生的学籍不能注册等问题，将严肃追究违规主体的责任。各地各校要按照省市学籍管理统一规定，普通高中学生按规定报到后，由就读学校按照学籍管理规定在学籍管理系统中发起高一新生注册程序。学籍注册、审核工作应于9月30日前完成。

保障措施

严肃招生纪律。

严禁无计划、超计划、超班额组织招生，招生结束后，学校不得擅自招收已被其他学校录取的学生;

严禁提前组织招生，变相“掐尖”选生源;

严禁公办学校与民办学校混合招生、混合编班;

严禁以高额物质奖励、虚假宣传等不正当手段招揽生源;

严禁地方政府、有关单位和任何学校收取或变相收取与入学挂钩的“捐资助学款”;

严禁初中学校对学生进行中考成绩排名、宣传中考状元和升学率。各学校招生简章、招生广告和招生方案须报经当地教育行政部门审批，并报市教育局备案同意后，方可向社会公布。

对于违规发布虚假信息的学校，一经发现，从严查处，并及时曝光。建立健全监督举报制度，广泛接受学生、家长和社会的监督。

严格实行责任追究。

各地要完善违纪举报和申诉受理机制，严肃查处违规违纪行为，对于造成不良影响或严重后果的学校，视情节轻重给予约谈、通报批评、追究相关人员责任等处罚。

对擅自扩大招生计划或自行录取普通高中录取最低控制分数线以下的考生，一律不予建立学籍，不能发放普通高中毕业证书，对违规招生的学校将予以通报批评，取消其当年评先评优资格，是示范学校的，取消其示范称号;

对在招生等规范办学行为方面被查处的学校，要按照不低于上年度招生计划10%的比例相应减少其招生计划;

对于民办学校，还可依据有关规定给予减少下一年度招生计划、停止当年招生直至吊销办学许可证的处罚。

适时对招生入学政策落地情况开展督导，对于造成恶劣社会影响的违规招生行为，列入市教育局督办事项，指导各地严肃查处追责。

市教育局咨询电话： 2197273(基教科)、2197288(考试管理中心)。投诉电话：2197227(驻局纪检组)。

普高特长生招生实施办法

特长生招生计划

特长生招生计划

不得超过本校招生计划的5%

招生原则

坚持公开、公平、公正

坚持考生自愿

坚持择优录取

特长生资格条件

特长生是指初中阶段在市级及以上教育行政部门举办或认可的艺术、体育、信息技术和科技类等比赛中取得优异成绩，或在这些方面有突出特长，经集中测试认为确有发展潜力的，综合素质评价等级为C等(含C等)以上，参加中考的应届初中毕业生。

特长生招生类别

特长生招生类别分为体育类、艺术类、信息技术类和科技类四个类别，普通高中学校根据自身办学条件和特色发展的需要确定特长招生类别，不得超出规定的招生范围。

招生程序

发布专业考核方案

特长生招生学校要围绕办学特色，制定科学合理的招生实施方案(含特长生类别、数量、招生条件、招生程序以及各类别考生的测试内容、测试办法等细则)，报市教育局审核通过后，方可公布实施招生。学校于2019年6月15前向社会公布本校特长生招生方案。

学生报名

6月25日，具备招生条件的学生凭获奖证书原件到高中招生学校报名，仅限报一所高中学校。

专业考核

各校特长生专业测试时间一致，为6月29日上午9点，测试工作由学校组织实施，初选名单要在招生学校和毕业学校校园内公示3个工作日，主动接受社会监督。

结果上报

7月6日前，各学校将公示后的初选名单(专业考核合格考生的姓名、准考证号、性别、毕业学校等基本信息)报市教育局基础教育科。

特长生录取

按照考生专业考核成绩由高到低择优录取，但中考成绩必须达到当地的普通高中最低录取分数线，未完成的计划调回该校统招生计划。已录取为特长生的考生，不再参加其它高中招生录取。

有关要求

各招生学校要成立专门的工作班子，加强领导，明确责任分工。严格选聘评委专家，加强专业考核监督工作，切实执行规定的程序和要求，认真组织专业考核工作，并严格公示环节，确保考核工作公正公平。专业考核应侧重于考生的专业水平，不得组织文化课测试。严禁自行组织或与社会培训机构联合组织以选拔生源为目的的各类考试，或采用社会培训机构自行组织的各类考试结果。

各招生学校要严格审查考生录取资格，不得在规定的范围和项目外招生。对因资格审查不严或弄虚作假、冒名顶替造成误录取以及擅自突破招生范围和计划的，将严格按照有关规定追究相关责任人的责任。建立并完善责任制度、公示制度、申诉制度，增加信息透明，保证招生办法、过程和结果的公正公平公开。

普高志愿设置填报及录取工作办法

录取批次及志愿设置

第一批次：特长生招生。考生不需要填报志愿。

第二批次：省级示范高中招生。先录取统招生，后录取指标到校生。统招生和指标到校生实行统一志愿，即考生所填报的省级示范高中志愿，包括统招志愿和指标到校生志愿，两项志愿合并填报。该批次共设置 A、B、C、D四个平行志愿。

第三批次：普通高中(含市示范高中、民办高中)招生。该批次共设置A、B、C、D、E、F六个平等志愿。

志愿填报

1

2

考生无论在哪里填报的普通高中志愿，均须在县市区指定确认点打印确认表并本人签字确认，他人不得代签。考生未按要求按时签字确认的，或由他人代为签字的，后果由考生本人负责。考生确认志愿信息若与预填表不一致，可到县市区招办按预填表所填志愿予以更正。确认后的志愿信息任何人不得变更。考生志愿确认表和预填表由确认点负责收齐统一整理装袋密封后交县市区保存备查。

太和、界首两地普通高中组织采用摇号派位划片分配方式录取。两地考生可填报市直属普通高中志愿，太和、界首教育局要设立志愿填报点，不得以任何理由拒绝符合条件的考生填报志愿。任何高中学校不得设置或委托社会机构设置志愿填报点。

3

志愿填报时间

4

有关说明

综合素质评价中有“D”的考生不能填报省示范高中志愿，综合素质评价中超过1个“D”的不能填报市示范高中志愿。

普通高中录取办法

一

普通高中

录取原则

若考生的中考总分相同，则看考生语数外三科成绩之和;若考生该三科成绩仍然相同，则看考生语数两科成绩之和;若考生该两科成绩再相同，则看考生的语文单科成绩。

省级示范高中在录取时，学生的综合素质评价5个维度中不能出现D等级;市级示范高中在录取时，学生的综合素质评价5个维度中不能超过1个D等级。

投档方式

首先按照考生从高分到低分排序，然后按照总分将考生从高分到低分排序，然后按照考生所填的平行志愿顺序依次检索录取，只要考生填报的志愿中，出现符合投档学校的学校即向该校投档。对于A志愿填报省示范高中的考生，先检索该志愿是否符合统招投档条件，若符合统招投档条件，则向该校投档;若不符合统招投档条件，再检索该志愿是否符合指标到校生投档条件，若符合条件则向该校投档;若仍不符合投档条件，则检索该生的B志愿，依此类推。

市级示范高中、一般普通高中和民办高中录取。由于学校没有指标到校生计划，录取时只对考生所填平行志愿检索统招投档条件，不再检索指标到校生投档条件。

招生录取流程

1.预投档。

正式投档录取前进行预投档，对考生进行多重排序，得到一个从高到低的考生投档顺序位，投档时按投档顺序位，根据考生志愿依次逐个检索投档。指标到校生计划完不成，剩余指标转为统招计划 ，再次进行预投档。预投档采取多轮投档方式，直到指标到校生计划不再出现空额为止，才进行正式投档。

2.录取流程。

首先检索该考生填报的A志愿学校的招生计划类型，如果该计划未满，即向A校投档;如果该考生填报的A志愿学校所有类型计划已满，则继续检索该考生填报的B志愿学校。如果该考生填报的B志愿学校计划类型未满，则向B校投档。以此类推，若还未有效投档，计算机继续处理投档顺序位的下一位考生。

3.同一考生不得重复录取。