Spring Boot 进阶：application.properties 与 application.yml 的全方位对比与最佳实践

博主社群介绍： ① 群内初中生、高中生、本科生、研究生、博士生遍布，可互相学习，交流困惑。 ② 热榜top10的常客也在群里，也有数不清的万粉大佬，可以交流写作技巧，上榜经验，涨粉秘籍。 ③ 群内也有职场精英，大厂大佬，跨国企业主管，可交流技术、面试、找工作的经验。 进群免费赠送写作秘籍一份，助你由写作小白晋升为创作大佬，进群赠送ZEEKLOG评论防封脚本，送真活跃粉丝，助你提升文章热度。 群公告里还有全网大赛约稿汇总/博客提效工具集/ZEEKLOG自动化运营脚本 有兴趣的加文末联系方式，备注自己的ZEEKLOG昵称，拉你进群，互相学习共同进步。 

文章目录

• 1. 导读与文章目标
  • 1.1 文章目标
  • 1.2 适用读者
• 2. 配置文件格式基础对比
  • 2.1 基本语法层级结构
    • 2.1.1 application.properties
    • 2.1.2 application.yml
• 3. 配置结构对比：嵌套与列表
  • 3.1 嵌套对象表达
    • 3.1.1 properties 表达复杂结构
    • 3.1.2 YAML 表达复杂结构（推荐）
  • 3.2 Mermaid 比较图
• 4. 多环境配置：profiles 使用方式
  • 4.1 properties 方式
  • 4.2 YAML 方案（更简洁）
• 5. 在 Spring Boot 中的加载顺序
  • 5.1 官方顺序（简化版）
  • 5.2 Mermaid 顺序图
• 6. 配置绑定：@Value vs @ConfigurationProperties
  • 6.1 properties 与 yml 都支持
    • 6.1.1 @Value 示例
    • 6.1.2 @ConfigurationProperties 示例
• 7. 哪种方式更受社区推荐？
  • 7.1 官方更推荐 YAML
  • 7.2 但 properties 仍具价值
• 8. 表格总结：properties vs yml 全面对比
• 9. 常见坑点与最佳实践
  • 9.1 YAML 容易踩的坑
    • 9.1.1 缩进错误
    • 9.1.2 Tab 键禁用
  • 9.2 properties 容易踩的坑
    • 9.2.1 字符串包含等号需要转义
• 10. 真实业务中的推荐实践
  • 10.1 小型项目（个人、小工具）
  • 10.2 中大型业务系统
  • 10.3 配置覆盖策略
• 结束语

1. 导读与文章目标

1.1 文章目标

本篇文章旨在从多个角度深入探讨 application.properties 与 application.yml，覆盖但不限于：

• 语法层面差异
• 可读性与维护性
• 多环境配置策略
• 配置注入、层级结构表达
• 复杂配置场景（多维结构、列表、Map）
• 与 Spring Boot 官方推荐的使用方式
• 高级技巧与避坑指南

1.2 适用读者

• Spring Boot 初学者
• 对配置管理有更高要求的后端工程师
• 架构师、技术负责人
• 希望写出更规范、更可维护项目的开发者

2. 配置文件格式基础对比

2.1 基本语法层级结构

2.1.1 application.properties

properties 本质上是 “键值对平铺结构”。

示例：

server.port=8080 spring.datasource.url=jdbc:mysql://localhost:3306/demo spring.datasource.username=root 

它的特点：

2.1.2 application.yml

YAML 是一种更现代、更表达式的配置格式，支持嵌套结构与列表。

示例：

server:port:8080spring:datasource:url: jdbc:mysql://localhost:3306/demo username: root 

YAML 特点：

3. 配置结构对比：嵌套与列表

3.1 嵌套对象表达

这部分是 YAML 完胜 properties 的典型场景。

3.1.1 properties 表达复杂结构

user.address.city=Shanghai user.address.street=East Road user.roles[0]=admin user.roles[1]=editor 

非常冗长，不够直观。

3.1.2 YAML 表达复杂结构（推荐）

user:address:city: Shanghai street: East Road roles:- admin - editor 

3.2 Mermaid 比较图

application.properties平铺结构列表需按下标展开阅读复杂配置困难application.yml缩进表达层级天然支持列表适合复杂场景

图 1：properties 与 yml 结构表达能力对比

4. 多环境配置：profiles 使用方式

4.1 properties 方式

spring.profiles.active=dev 

多环境：

application-dev.properties application-prod.properties 

4.2 YAML 方案（更简洁）

spring:profiles:active: dev 

甚至支持多配置块合并：

server:port:8000---spring:profiles: dev server:port:8001---spring:profiles: prod server:port:9001

5. 在 Spring Boot 中的加载顺序

理解加载顺序至关重要，不同环境下配置冲突时，知道谁覆盖谁能避免线上事故。

5.1 官方顺序（简化版）

1. 命令行参数（优先级最高） 2. application.properties / yml（classpath） 3. 外部配置文件（优先级更高） 4. @PropertySource 5. @ConfigurationProperties 默认值 

5.2 Mermaid 顺序图

命令行参数外部 application.yml内部 application.yml@ConfigurationProperties覆盖覆盖覆盖命令行参数外部 application.yml内部 application.yml@ConfigurationProperties

6. 配置绑定：@Value vs @ConfigurationProperties

6.1 properties 与 yml 都支持

但 YAML 在对象绑定时可读性更强。

6.1.1 @Value 示例

@Value("${user.address.city}")privateString city;

适用于：简单值注入。

6.1.2 @ConfigurationProperties 示例

示例 YAML：

user:name: Jack age:20address:city: Shenzhen 

Java 绑定：

@ConfigurationProperties(prefix ="user")@DatapublicclassUserConfig{privateString name;privateInteger age;privateAddress address;@DatapublicstaticclassAddress{privateString city;}}

7. 哪种方式更受社区推荐？

7.1 官方更推荐 YAML

原因：

1. 配置清晰，层次结构更明显
2. 更适合复杂配置（Redis、Kafka、微服务配置）
3. 支持多 profile 合并写法

7.2 但 properties 仍具价值

尤其在：

• 小项目
• 工具类
• DevOps 配置大量使用 properties
• IDE 搜索更精确（键名搜索）

8. 表格总结：properties vs yml 全面对比

9. 常见坑点与最佳实践

9.1 YAML 容易踩的坑

9.1.1 缩进错误

示例（错误）：

user:name: Tom 

必须是 2 个空格缩进：

user:name: Tom 

9.1.2 Tab 键禁用

YAML 不允许使用 Tab。

9.2 properties 容易踩的坑

9.2.1 字符串包含等号需要转义

password=p@ss=123 # 可能被解析异常 

10. 真实业务中的推荐实践

10.1 小型项目（个人、小工具）

• 使用 application.properties
• 原因：结构简单，文件短小，IDE 搜索友好

10.2 中大型业务系统

• 使用 application.yml
• 特别适合以下场景：
  • Redis、Kafka、RabbitMQ 多实例管理
  • 微服务配置大量嵌套结构
  • 多环境配置需要合并

10.3 配置覆盖策略

优先级顺序：

云配置 > 外部 yml > 内部 yml > properties > 默认值 

如果你需要我进一步批量处理格式、自动转换为 Markdown 或生成 PDF，也可以继续告诉我。

结束语

👨‍💻 关于我

持续学习 | 追求真我

如果本篇文章帮到了你 不妨点个赞吧~ 我会很高兴的。想看更多 那就点个关注吧 我会尽力带来有趣的内容 😎。

感谢订阅专栏 三连文章

掘金点击访问QiunerZEEKLOG点击访问QiunerGitHub点击访问QiunerGitee点击访问Qiuner

你好,我是Qiuner. 为帮助别人少走弯路而写博客

如果本篇文章帮到了你 不妨点个赞吧~ 我会很高兴的 😄 (^ ~ ^) 。想看更多 那就点个关注吧 我会尽力带来有趣的内容 😎。

代码都在Github或Gitee上，如有需要可以去上面自行下载。记得给我点星星哦😍

如果你遇到了问题，自己没法解决，可以去我掘金评论区问。ZEEKLOG评论区和私信消息看不完 掘金消息少一点.