Properties 配置文件：Java 生态的键值格式

Properties 是 Java 平台长期使用的持久化键值格式。每个键和值在 java.util.Properties 中都应是字符串，文件采用简单的逐行结构，常见于 Java 应用、框架配置和资源文件。

它与 .env 一样是扁平键值，但拥有 Java API 明确规定的分隔、转义、续行和编码行为。项目通常使用点号模拟层级，再由框架把字符串转换为目标类型。

app.name=config-demo
app.debug=false
app.features=search,cache
server.host=127.0.0.1
server.port=8080
database.pool-size=10

点号和连字符只是键名的一部分，并不会自动创建对象。false、8080 和 10 也都是字符串；Spring 等框架可以提供绑定和类型转换，但那属于框架能力，不是 Properties 文件自身的数据类型。

键和值通常用 = 分隔：

server.port=8080

Java 的标准加载格式也允许 : 或未转义空白作为分隔符：

server.host: 127.0.0.1
log.level INFO

为了减少歧义，新文件最好统一使用 =。# 或 ! 开始注释：

# 本地开发监听地址
server.host=127.0.0.1

行尾使用未转义反斜杠可以续行。下一行开头的空白会被忽略：

app.features=search,\
  cache,\
  metrics

反斜杠还用于转义特殊字符，例如 \t、\n、\r、\f 和 Unicode 的 \uXXXX。Windows 路径中的反斜杠也要按读取 API 的规则正确转义。

编码是 Properties 最容易被简化过度的部分：

因此不能只说“.properties 永远是 ISO-8859-1”或“现代 Java 都自动按 UTF-8”。应明确使用哪个 API 或框架，并用包含中文的真实样本测试。

Properties 适合：

新建的复杂配置若需要数组、对象和明确类型，可评估 TOML 或 YAML；如果参数最终来自部署环境，则使用环境变量更直接。

Properties 也可以保存为特定 XML 结构，但这仍是 Properties API 的另一种持久化形式，不等于任意 XML 配置。

如果 Java 框架已经把 Properties 作为稳定入口，继续使用通常成本最低。保持键名清晰、类型转换集中、编码明确，并提供无秘密示例文件即可。

当配置逐渐出现嵌套对象、复杂列表和大量类型约束时，应评估框架支持的 YAML 或其他结构化格式；不要继续在单个字符串中叠加越来越复杂的自定义语法。