java: 找不到符号 符号: 变量 log

### Java 编译错误 "找不到符号" 变量 `log` 的解决方案

当遇到Java编译器报告“找不到符号”的错误，特别是针对变量`log`时，这通常意味着程序试图访问一个未声明或不可见的成员。具体到日志记录工具中的`log`对象，这类问题往往源于以下几个方面：

#### 日志框架缺失或配置不当
为了能够正常使用诸如`log.info()`这样的语句来打印调试信息，应用程序必须引入相应的日志库并正确初始化它。如果没有导入合适的依赖项或者未能按照所选的日志实现方式完成必要的设置，则会出现上述提到的编译期错误。

#### Lombok 插件相关的问题
Lombok 是一种简化Java语法的小型库，通过注解自动生成样板代码。例如，@Slf4j 注解可以用来快速创建SLF4J风格的日志实例。然而，在某些情况下，即使源码里包含了这些注解，但如果IDE（如IntelliJ IDEA）没有正确识别它们或是Gradle构建过程中存在问题，也会触发类似的编译警告[^3]。

#### IDE 配置调整建议
有时即便环境看起来已经准备就绪，仍然可能因为一些细微之处影响到了最终的结果。比如在使用Lombok的情况下，确保已经在项目的根目录下的`.idea/compiler.xml`文件中加入了特定参数以优化处理过程；即添加如下所示的内容至<compiler>标签内：

<option name="additionalOptions">
    <list>
        <item>-Djps.track.ap.dependencies=false</item>
    </list>
</option>

这样做有助于防止因注解处理器引起的不必要的重复编译行为，进而提高整体效率的同时也解决了潜在的编译问题[^5]。

#### 实际操作指南
考虑到不同开发者的工作流差异较大，这里给出几种通用的方法供参考：

- **确认依赖**：检查build.gradle (对于 Gradle 用户) 或 pom.xml(如果是 Maven)，保证slf4j-api 和 lombok 库已被加入dependencies部分。

- **更新/重启IDE**：有时候简单的刷新项目结构、清理缓存甚至完全关闭再重新打开IDE都能带来意想不到的效果。

- **验证插件状态**：进入Settings -> Plugins 查看是否有最新版本可用，并保持其处于激活状态。

最后附上一段标准形式的日志输出示范代码片段作为补充说明：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Example {
    
    private static final Logger logger = LoggerFactory.getLogger(Example.class);

    public void doSomething() {
        logger.debug("This is a debug message.");
        logger.info("Informational message here.");
        logger.warn("Warning occurred!");
        logger.error("An error happened.", new Exception("example"));
    }
}