Log4j2 的 %c{precision} 支持多种灵活的 logger 名称缩写策略，尤其适用于深度包路径（如 org.apache.spark.util.Utils），可通过 1.2* 等语法实现“前缀缩为单字母、末尾保留完整组件”的定制化显示。
log4j2 的 `%c{precision}` 支持多种灵活的 logger 名称缩写策略，尤其适用于深度包路径（如 `org.apache.spark.util.utils`），可通过 `1.2*` 等语法实现“前缀缩为单字母、末尾保留完整组件”的定制化显示。
在 Log4j2 中，%c（等价于 %logger）用于输出日志事件所属 Logger 的名称，而其后的 {precision} 参数决定了如何截取或缩写该名称。你期望的效果——例如将 org.apache.spark.util.Utils 显示为 o.a.s.util.Utils（即前缀各缩为 1 字母，最后 2 个组件保持完整）——*自 Log4j2 v2.20.0 起可通过 `%c{1.2}` 精准实现**。
✅ 正确用法：%c{1.2*}
该语法含义如下：
- 1：表示所有非末尾保留组件（即除最后 2 个外的部分）均缩写为 1 个字母 + 点号（.）；
- 2*：表示最右侧的 2 个组件（util 和 Utils）完整输出，不缩写；
- * 是关键标记，表明后续数字指定的是“保留完整组件的数量”。
验证示例（Log4j2 ≥ 2.20.0）：
MiniMax 媒体生成
下载
一款AI音频处理工具，主要用于MiniMax统一媒体生成技能，用于TokenPlan工作流。当用户要求生成音频、语音、TTS、旁白、图片、插图、姿势等媒体内容时使用，适合需要提升相关任务效率的用户。
<!-- log4j2.xml 配置片段 -->
<patternlayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %c{1.2*} - %msg%n"></patternlayout>
对应日志输出：
10:23:45.123 [main] INFO project.class - hello 10:23:45.124 [main] INFO o.a.s.util.Utils - hello
⚠️ 注意：%c{1.2.*}（带点）是错误写法——官方文档中示例虽含点，但实际解析器要求 * 必须紧邻数字，不允许中间插入 .。正确形式为 1.2*（无点）、1.3*、2.1* 等。
? 其他常用 precision 模式对照
| 模式 | 示例输入 | 输出 | 说明 |
|---|---|---|---|
| %c{2} | org.apache.commons.Foo | commons.Foo | 保留最右 2 个组件 |
| %c{-2} | org.apache.commons.Foo | commons.Foo | 删除最左 2 个组件 |
| %c{1.} | org.apache.commons.Foo | o.a.c.Foo | 所有组件缩为 1 字母（含末尾） |
| %c{1.2*} | org.apache.spark.util.Utils | o.a.s.util.Utils | 前缀缩 1 字母，末 2 组件完整 |
| %c{2.1*} | com.example.service.UserService | co.ex.se.service.UserService | 前 2 组件各取前 2 字母，末 1 组件完整 |
? 注意事项与最佳实践
- 版本强依赖：1.n* 语法仅在 Log4j2 ≥ 2.20.0 中可用（见 LOG4J2-2785）。旧版本会忽略 * 或报错，请务必升级并验证。
- 避免混淆符号：不要写成 %c{1.2.*} 或 %c{1.2.*} —— 正确格式为 %c{1.2*}（无额外点）。
- 与包名规范协同：该模式依赖 . 作为组件分隔符，确保 Logger 名严格遵循 Java 包命名惯例（如 org.apache.spark.util.Utils），避免自定义分隔符。
- 性能影响极小：缩写逻辑在日志格式化阶段执行，不影响日志记录性能，可放心用于生产环境。
通过合理选用 %c{1.2*}，你既能保持日志可读性（关键类名完整），又能显著压缩长包路径占用的宽度，提升日志扫描效率——这是微服务与大数据场景下精细化日志治理的重要技巧。
