写日志这件事看似简单，实则蕴含许多技巧。要在代码中输出符合工程规范、便于后续问题定位的结构化日志，仅仅依赖System.out.println或随手写一句logger.info是远远不够的。你需要结合具体的业务上下文、埋点目标，再借助通义灵码这类工具的智能续写能力，才能生成字段完整、索引清晰、检索高效的日志语句。

用通义灵码自动生成结构化日志语句

在Java方法内部，将光标放置在需要写日志的位置，按下 Alt + P（Windows）或 Option + P（Mac），触发通义灵码的行级续写功能。接着直接输入自然语言提示，例如：“记录用户下单成功日志，包含order_id、user_id、amount、pay_channel，级别为INFO，使用slf4j的logger对象”。

通义灵码会立即生成类似这样的代码：
logger.info("order_success | order_id={} | user_id={} | amount={} | pay_channel={}", orderId, userId, amount, payChannel);

这一步有一个硬性要求：字段顺序必须与占位符严格对应，否则运行时直接抛出ArrayIndexOutOfBoundsException异常。通义灵码默认按照提示中的字段顺序生成，但它不会自动校验代码里的变量名——你在提示里写user_id，实际变量可能是uid，这时就需要人工逐一核对。

根据埋点类型选择合适的日志模板

方法一：用户行为埋点（按钮点击、页面曝光等）
在事件触发入口处，右键 → 通义灵码 → “生成日志埋点”，选择“用户行为”模板，它会自动插入包含event_id、page_name、element_id、timestamp的标准日志格式。

方法二：系统异常埋点
选中try-catch块中的catch分支，在异常变量上右键 → 通义灵码 → “生成错误日志”。它会自动提取异常类型、堆栈首行、关键业务ID（例如订单号），用ERROR级别输出，同时带上trace_id（如果你的项目已经集成了SkyWalking或SLS）。

方法三：接口耗时埋点
把光标放在方法第一行，输入“添加接口耗时日志，开始时间戳、结束时间戳、耗时毫秒、status（success/failed）”，通义灵码会生成带有StopWatch或System.nanoTime()的环绕日志，并且自动对齐Logstore索引字段的命名规范，比如duration_ms、status。

强制统一日志格式的三步操作

第一步：打开IDEA → Settings → Editor → Live Templates → 点击+号 → Template Group → 命名为“LingmaLog”。

第二步：在该组下新建Live Template，Abbreviation填logbiz，Description写“业务埋点标准日志”，Template text粘贴以下内容：
logger.info("$LEVEL$ | $EVENT$ | trace_id=$traceId$ | $FIELDS$");

第三步：点击Edit variables，为$LEVEL$设置默认值为“INFO”，$EVENT$设为“custom_event”，$FIELDS$留空（由通义灵码填充）；勾选“Reformat according to style”。注意：这个模板必须绑定到Java文件类型，否则在XML或YAML中也会误触发，那就不对了。

避免日志污染的两个硬性约束

通义灵码生成日志时默认不会自动过滤敏感字段。如果你的提示词里出现“手机号”“身份证号”这类关键词，它可能直接生成包含明文的log语句——这在GDPR和等保要求下是绝对不允许的。

正确的做法是：手动替换为脱敏写法。例如把phone=138****1234改成phone={}", MaskUtils.maskPhone(phone)。通义灵码不认识MaskUtils，所以所有包含PII字段的日志，必须在采纳前手动插入脱敏函数调用。

另一个常见陷阱是日志级别一刀切。记住：支付失败必须用ERROR，页面加载超时用WARN，用户登录成功用INFO。通义灵码不会替你判断严重性，全靠你在提示词里明确指定。