IntelliJ 本地日志路径自定义：`-DLOG_PATH=./logs` 为什么总“不听话“

原创已于 2026-09-11 19:27:14 修改 · 366 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

话题

#开学季·九月创作之星博客挑战赛

于 2026-09-11 19:23:04 首次发布

IntelliJ 本地日志路径自定义：`-DLOG_PATH=./logs` 为什么总"不听话"

一篇写给初学者的实战博客，回答两个高频问题：

怎么让本地跑起来的项目，日志不落到 /opt/log，而是落到我想指定的目录；
在父目录打开 IDEA、运行子项目时，为什么日志落到了父目录，怎么让它落回子项目自己的目录。

文末附命令行 / VS Code 的等价做法和速查表。

一、先看现象

我们的日志框架（log4j2）配置文件里，日志路径是这样定义的：

<!-- 定义日志存储的路径，不要配置相对路径；本地开发可通过 JVM 参数 -DLOG_PATH=./logs 覆盖，默认 /opt/log -->
<property name="FILE_PATH" value="${sys:LOG_PATH:-/opt/log}"/>

这个语法读起来是：取 JVM 系统属性 LOG_PATH；没设置的话，用默认值 /opt/log。

于是问题来了：

生产环境（Linux）日志写到 /opt/log，给 K8s 挂载采集，没问题；
本地开发（Windows）也写到 /opt/log——Windows 会把它解析成进程所在盘符根目录，比如 D:\opt\log，所有项目的日志全混在一个文件夹里；
更糟的场景：在父目录 a_recommend_core 打开 IDEA，点运行子项目 recommend-core-kfc-ai-cms-ad，加了 -DLOG_PATH=./logs，结果日志落到了父目录 a_recommend_core\logs，而不是子项目自己的 logs\。

要解决这两个问题，只需要理解一个核心规则。

二、核心规则：`./` 永远跟着 JVM 的"工作目录"走

把一件事拆成三个角色：

角色	是什么	谁决定
`-DLOG_PATH=./logs`	向 JVM 注入系统属性 `LOG_PATH`，值是字符串 `"./logs"`，此刻还没有任何目录含义	你，在 VM 选项里填
`${sys:LOG_PATH:-/opt/log}`	log4j2 读这个属性，拿到字符串 `"./logs"`	日志框架
`./logs` 的 `./`	相对路径，相对于 JVM 进程的"工作目录"（Working Directory）——即进程启动时所在的目录	IDEA 的运行配置里的"工作目录"字段，不是你 IDEA 打开了哪个目录，也不是代码里写了什么

所以"日志落哪"的完整链路是：

-DLOG_PATH=./logs  →  log4j2 拿到 "./logs"  →  JVM 工作目录是 X  →  日志写到 X\logs

日志落错地方，99% 是第三个环节错了：你以为工作目录是子项目，IDEA 默认给的却是别处。

三、第一步：把 `-DLOG_PATH=./logs` 填对地方

IntelliJ 的运行配置里有两个长得像的输入框：

VM 选项（VM options）→ -DLOG_PATH=./logs 填这里 ✓
程序实参（Program arguments）→ 这是传给 main(String[] args) 的参数，填这里完全不生效 ✗

找不到 VM 选项输入框？点配置页里的 修改选项（Modify options）→ 勾选 添加 VM 选项。

新 IDEA 版本里 -D 参数甚至会自动提示放错位置（程序实参里填 -D 会标黄警告），看到警告就挪过去。

四、第二步（真正的坑）：工作目录

4.1 两种宏

IntelliJ 的"工作目录"字段常用两个预定义值：

宏	含义	多模块项目里的表现
$ProjectFileDir$	你打开的那个 IDEA 工程的根目录	在父目录打开工程 → 就是父目录（默认值，坑的来源）
$MODULE_WORKING_DIR$	这条运行配置所属"模块"的内容根目录	选对模块 → 就是子项目自己的目录 ✓

默认值是 $ProjectFileDir$ 。这就是"在父目录打开 IDEA、运行子项目、日志落到父目录"的直接原因：./logs 相对父目录解析了。

4.2 正确设置（中文版 IDEA 菜单）

单条配置改法：

右上角运行配置下拉 → 编辑配置…
选中你的启动项（如 RecommendCoreApplication）
工作目录 字段改成 $MODULE_WORKING_DIR$ （或直接填绝对路径，见 4.4）
应用 → 完全停止进程 → 重新运行

一次改所有（推荐）：

编辑配置… → 左下角 编辑配置模板… → 选 Spring Boot → 工作目录填 $MODULE_WORKING_DIR$ 。
模板只影响之后新建的配置；已有配置要逐条改。

4.3 $MODULE_WORKING_DIR$ 还是落父目录？——看"模块"

$MODULE_WORKING_DIR$ 解析的是这条配置关联的模块的内容根。多模块项目里，每个子项目是一个模块：

a_recommend_core（父工程，也可能被 IDEA 当成一个模块）
├── recommend-core-kfc-ai-cms-ad      ← 模块 A
├── recommend-core-kfc-cube-product   ← 模块 B
├── recommend-core-multi-rgm          ← 模块 C
└── ...

如果运行配置里模块下拉框（在主类下方，可能要往下滚动）选成了父工程对应的模块，宏照样解析到父目录。把它选成目标子项目对应的模块即可。

4.4 终极兜底：绝对路径

不想跟宏、模块较劲，直接把工作目录填死：

D:\a_recommend\a_recommend_core\recommend-core-kfc-ai-cms-ad

缺点是每条配置、每个项目各填一次；优点是永远不可能解析错。个人开发机上这往往是最省心的选择。

五、验证：看时间戳，不靠猜

改完后必须完全停止再重启（修改配置不会影响正在运行的进程），然后对比两边文件：

# 哪个目录的 app.log 刚刚更新，日志就落哪了
Get-ChildItem D:\a_recommend\a_recommend_core\logs\app.log,
              D:\a_recommend\a_recommend_core\recommend-core-kfc-ai-cms-ad\logs\app.log

如果两边都没更新，回头查两件事：-DLOG_PATH=./logs 是不是填进了程序实参；或者压根没加（此时日志按默认值落到了 D:\opt\log）。

六、命令行执行时的等价规则

命令行没有"工作目录字段"——你在哪个目录敲命令，工作目录就是哪：

# java -jar：先 cd 进目标项目，./logs 就是项目的 logs
cd D:\a_recommend\a_recommend_core\recommend-core-kfc-ai-cms-ad
java -DLOG_PATH=./logs -jar target\recommend-core-kfc-ai-cms-ad-1.0.0.jar

# mvn spring-boot：插件默认继承 Maven 进程的工作目录
cd D:\a_recommend\a_recommend_core\recommend-core-kfc-ai-cms-ad
mvn spring-boot:run "-Dspring-boot.run.jvmArguments=-DLOG_PATH=./logs"

# 跑单测：surefire 默认工作目录就是模块根目录，天然落对
mvn test "-DargLine=-DLOG_PATH=./logs"

七、VS Code 的等价做法（对照理解）

VS Code 同样是"工作目录 + VM 参数"两件套，写在 launch.json 的每个配置里：

{
    "type": "java",
    "name": "cms-ad (logs→recommend-core-kfc-ai-cms-ad/logs)",
    "request": "launch",
    "mainClass": "com.yumchina.recommend.aicmsad.RecommendCoreApplication",
    "vmArgs": "-DLOG_PATH=./logs",                                    // ← 相当于 VM 选项
    "cwd": "${workspaceFolder}/recommend-core-kfc-ai-cms-ad"          // ← 相当于工作目录
}

和 IDEA 一一对应：cwd 就是"工作目录"，vmArgs 就是"VM 选项"。多模块父目录打开时，同样靠每条配置的 cwd 指向子项目来落对位置。

八、FAQ

Q1：加了 -DLOG_PATH=./logs，日志还是去 D:\opt\log？
说明系统属性没注入成功：多半填进了"程序实参"，或者改完没有重启进程。检查字段位置，停止重跑。

Q2：用了 $MODULE_WORKING_DIR$ 还是落父目录？
检查配置里"模块"下拉框是不是选成了父工程模块；或者干脆用绝对路径兜底。

Q3：改了配置怎么没变化？
运行中的进程不受配置修改影响，必须停止后重新运行。热部署/热交换（HotSwap）不会重读 -D 参数。

Q4：好几个项目的主类都叫 RecommendCoreApplication，运行配置分不清谁是谁？
看配置详情里的主类全限定名（包名不同：aicmsad / cubeproduct / multi_rgm），并把配置名改成带项目标识的名字，避免跑错项目还以为日志丢了。

Q5：团队协作，绝对路径每个人不一样怎么办？
用 $MODULE_WORKING_DIR$ + 模块选对，提交到 .run/ 目录（IDEA 支持把运行配置存成文件共享）；绝对路径只适合个人本机。

九、速查表

症状	原因	解决
日志出现在 `D:\opt\log`	`LOG_PATH` 属性没注入（填错框/没加/没重启）	填到 VM 选项，停止重跑
日志出现在父目录 `a_recommend_core\logs`	工作目录是 $ProjectFileDir$ （父目录）	改 $MODULE_WORKING_DIR$ 或绝对路径
用了宏还是落父目录	配置的"模块"选成了父工程	模块下拉选目标子项目
每个项目的日志混在一起	所有项目都落同一个固定目录	各自配置 `./logs` + 各自工作目录

一句话总结：-DLOG_PATH=./logs 只负责"用相对路径"，落在哪由 JVM 工作目录决定；IntelliJ 里把工作目录从 $ProjectFileDir$ 换成 $MODULE_WORKING_DIR$ （或选对模块 / 填绝对路径），在父目录跑子项目时日志就回到子项目自己的 logs\ 里了。

相关配置出处：

log4j2 路径定义：src/main/resources/log4j2.xml 的 FILE_PATH 属性
IntelliJ：运行配置的"VM 选项 / 工作目录"，模板入口"编辑配置模板…"
VS Code：.vscode/launch.json 的 vmArgs / cwd