金融行业科技部程序员代码开发规范手册.docxVIP

金融行业科技部程序员代码开发规范手册

第1章代码风格与命名规范

1.1文件命名规则与后缀约定

在金融科技开发中，文件名的规范性不仅是代码可读性的基础，更是构建可维护、可追溯系统架构的关键。遵循统一的命名约定能显著降低团队协作成本，减少因文件名混淆导致的配置错误。

所有文件必须遵循统一的命名前缀与后缀规范，严禁使用`file.java`或`main.cpp`等无意义后缀，推荐使用`company.module.Service.java`格式，明确标识所属模块与业务类型。项目根目录下必须配置`.gitignore`文件，严格忽略`.class`、`.log`、`.tmp`及`target`目录，确保版本控制系统只追踪真正需要提交的文件。

对于配置文件（如`application.yml`或`config.json`），必须使用小写单词并全限定命名，禁止使用`perties`或`settings.xml`等非标准格式，以匹配IDE自动补全功能。目录结构需严格对应业务逻辑分层，例如`src/main/java/com/finance/core/service/order/OrderService.java`应直接位于`com`包下，严禁跨包命名如`com/finance/order/OrderService.java`