软件工程开发规范与标准.docxVIP

软件工程开发规范与标准

第1章项目基础架构与通用规范

1.1项目目录结构与文件命名规范

项目根目录应严格遵循“模块-功能”命名逻辑，将代码分为“核心逻辑”、“工具类”、“数据模型”和“测试用例”四大独立子目录，确保每个功能模块拥有独立的物理空间，避免代码污染全局。文件后缀名需严格区分语言类型，Java类文件使用`.java`，资源文件使用`.properties`或`.properties`，配置文件使用`.xml`或`.yaml`，确保IDE能自动识别并正确加载资源。

目录层级结构必须自顶向下，根目录下仅保留`src`和`test`两个核心子目录，`src`下再按包名分层，`test`下按测试场景分层，严禁在模块内直接放置`.class`或`resources`目录，保持路径绝对简洁。所有Java源文件必须采用PkgName.ClassName命名规范，例如`ject.controller.UserController`，类名首字母大写，包名小写且符合包结构语义，杜绝驼峰命名或下划线命名。配置文件（如`application.yml`）必须使用驼峰命名法（snake_case），键名必须与类名中的包名完全一致，例如配置项`server.port`对应包名`ject.server`，确保运行时自动注入的键值对能精准匹配。

常量定义必须遵循常量命