Java程序编码规范.docxVIP

Java程序编码规范

前言

Java作为企业级后端开发的主流语言，其编码规范是提升代码质量、降低维护成本、保障团队高效协作的核心准则。本规范以Oracle官方编码规范为基础，结合阿里巴巴《Java开发手册》最新黄山版v1.7.1的核心要求，涵盖编码格式、命名规范、注释规范、语法规范、异常处理、资源管理等全维度内容，适用于各类Java项目开发，旨在统一编码风格、杜绝常见隐患、打造高可读性、高健壮性、可扩展性的工业级代码，同时减少技术债务，适配业务长期迭代需求。

一、通用基础规范

1.1编码格式

统一采用UTF-8编码格式，严禁使用GBK等其他编码，避免出现中文乱码问题；所有Java源文件必须以.java为后缀，且文件名需与公共类名完全一致（大小写敏感），否则会导致编译错误。

1.2缩进与空格

缩进统一使用4个空格，绝对禁止使用Tab键，建议在IDE（优先IDEA）中开启“将Tab替换为空格”配置，防止不同编辑器Tab显示宽度不一致导致排版错乱；空格使用遵循“松紧适度、清晰分隔”原则，具体要求如下：

二元运算符（+、-、*、/、==、!=、、、、||等）左右必须各加1个空格，例如inttotal=count*price+discount;，严禁写成inttotal=count*price+discount;。

一元运算符（++、--、!、~等）紧贴变量，不加空格，