软件业技术部程序员代码编写规范手册.docxVIP

软件业技术部程序员代码编写规范手册

第1章项目结构与代码组织

1.1项目根目录与文件命名规范

项目根目录（ProjectRoot）是代码仓库的“总指挥部”，所有、配置文件、依赖包及构建工具必须统一存放于此，严禁在子目录中随意放置核心业务逻辑文件，以确保版本控制（VersionControl）的高效迭代与迁移。文件命名必须严格遵循CamelCase（驼峰命名法）规则，即首字母大写，下划线分隔，且严禁使用中文、特殊符号或空格，例如`UserService.java`和`config/application.properties`，以符合IDE自动补全及代码搜索工具的解析逻辑。

每个Java类必须位于对应包名（Package）下，包名需与类名完全匹配，且包名应反映模块职责，如`com.example.demo.service.impl`对应`UserServiceImpl`，避免命名冲突导致编译错误。静态资源（如图片、CSS、JS）应放置在`public/static`目录下，通过`src/main/resources`下的`static`文件夹引用，严禁将图片直接拼接到Java源文件中，以防止因资源文件变动导致整个项目编译失败。配置文件（如`application.yml`,`application.properties`）