IntelliJ 平台测试日志定位与解析idea.log 轮转、IDE Starter 目录与 LogTestName 标记协议【免费下载链接】intellij-communityIntelliJ IDEA IntelliJ Platform项目地址: https://gitcode.com/GitHub_Trending/in/intellij-community本文讲解 IntelliJ IDEA / IntelliJ Platform 测试框架中日志文件idea.log的定位与解析方法覆盖日志轮转命名规律、IDE Starter 测试与常规非 Starter测试两类日志路径、LogTestName标记协议以及配套的 Python 辅助函数。读完本文你将掌握在测试运行后快速找回最新日志、按测试方法切分共享日志并能在 Notebook 或脚本中自动化分析测试日志的完整实操方案。idea.log 的轮转机制永远用 Glob 而非固定文件名IDE 与测试运行期间产生的日志统一写入idea.log。随着日志增长该文件会轮转旧的分段被命名为idea.1.log、idea.2.log依此类推数字越大越旧。因此绝不能硬编码idea.log这个固定文件名——最新的日志可能正躺在idea.1.log甚至更后面的分段里。正确做法是使用 Glob 模式idea*.log匹配同一目录下的全部日志分段按文件修改时间mtime排序取 mtime 最新的文件即为当前活跃日志若要按时间顺序重放历史则按 mtime 升序拼接。这一约定同时适用于下面的 IDE Starter 测试与常规测试两类场景。IDE Starter 测试每个测试独占一个日志目录IDE Starter 是平台用于启动 IDE 实例并运行集成测试的框架。它会把每个测试的日志写入一个专属目录路径模板为repo/out/ide-tests/tests/productCode-buildNumber/testName/log/idea*.log各段含义路径段含义repo仓库根目录例如 intellij-community 检出目录out/ide-tests/testsIDE Starter 测试输出根目录productCode产品代号例如IUIntelliJ IDEA Ultimate、ICCommunitybuildNumber构建号本地运行为LOCALCI 上为数字构建 IDtestName测试名称直接映射为一个独立目录log/idea*.log该测试实例的日志文件含轮转分段由于buildNumber在本地与 CI 上取值不同检索时必须对两者都做匹配例如用IU-*形式的 Glob。因为每个测试名映射到自己的目录IDE Starter 场景下不同测试的日志天然分离——不需要任何 marker 解析直接按目录取文件即可。find_log按 mtime 定位最新测试日志配合上述目录结构可用如下 Python 函数定位某个测试的最新日志from pathlib import Path def find_log(test_name: str) - Path: matches sorted( (repo_root / out / ide-tests / tests).glob( fIU-*/{test_name}/log/idea*.log ), keylambda p: p.stat().st_mtime, ) if not matches: raise FileNotFoundError( fNo idea.log found for test {test_name}. Run the test first, then re-execute this cell. ) path matches[-1] # most recently modified print(f{test_name}: {path}) return path实现要点Glob 模式IU-*/{test_name}/log/idea*.log同时覆盖IU-LOCAL/...与IU-数字构建号/...两种目录按st_mtime排序并取matches[-1]对应按 mtime 排序后取最新文件的轮转处理原则日志缺失时抛FileNotFoundError是有意为之测试必须先运行、产生日志Notebook 才能做后续分析。缺失日志是硬性前置条件而不是可选的降级模式因此用异常作为明确信号避免静默失败导致下游分析基于空数据。常规非 Starter测试共享日志 LogTestName 标记普通单元/集成测试不经过 IDE Starter日志写入共享的系统日志目录system/test/testlog/idea*.log关键约束是日志不会在测试方法之间清空——一次测试运行中的所有测试共享同一组轮转文件。此时要从共享日志中抽取某个测试的记录必须依靠LogTestName标记进行分界。标记格式如下 Started a test: ClassName::testMethodName ...log lines for this test... The test finished successfully: ClassName::testMethodName 测试开始标记Started a test: ClassName::testMethodName结束标记The test finished successfully: ClassName::testMethodName失败时为The test failed: ...。LogTestName 的注册方式LogTestName全名com.intellij.testFramework.junit5.LogTestName文档所述是 JUnit 5 的InvocationInterceptor。启用方式有两种显式扩展在测试类上添加ExtendWith(LogTestName::class)传递注册若测试类已使用TestApplicationLogTestName可能已被其传递性地注册无需重复添加。如果LogTestName不适用例如 JUnit 4 测试、没有 application context 的场景则需要手动打标记在测试方法体首尾各加一次LOG.info调用输出与上述格式一致的开始/结束文本以便后续按同一协议解析。extract_test_section按标记切出单个测试的日志拿到共享日志全文后用如下函数切出指定测试的日志区间import re def extract_test_section(log_text: str, test_display_name: str) - str: Return log lines between the Started and finished/failed markers for one test. start re.search(rStarted a test: re.escape(test_display_name), log_text) if not start: return tail log_text[start.end():] end re.search( rThe test (?:finished successfully|failed): re.escape(test_display_name), tail, ) return tail[:end.start()] if end else tail解析要点re.escape(test_display_name)测试名如ClassName::testMethodName含::等正则元字符必须转义后再拼入模式避免误匹配开始标记缺失时返回空串说明日志里没有该测试的记录可能未运行或日志已轮转丢失结束标记同时匹配成功与失败(?:finished successfully|failed)保证无论测试结果如何都能正确切出区间若日志截断导致找不到结束标记则返回从开始标记到文件末尾的全部内容。仓库内的日志路径配置佐证在 intellij-community 仓库中可以找到与上述机制对应的底层配置bin/idea.properties 中预留了idea.log.path${idea.system.path}/log的注释示例说明日志目录默认位于 IDE 系统目录system下可自定义路径——这正是常规测试日志system/test/testlog/idea*.log中system段的来源IdeLauncher.kt 在启动 IDE 时通过-Didea.log.path${environmentPaths.logFolder}显式指定日志目录说明 IDE Starter 这类启动器会为每个实例注入独立的日志路径从而支撑每个测试独占一个日志目录的目录结构。结合文档与这两处源码可以确认日志目录是通过idea.log.path系统属性控制的Starter 测试与常规测试的差异本质上是该属性被指向了不同目录专属目录 vs. 共享system/test/testlog而共享目录场景下则必须依赖LogTestName标记协议做日志分界。实践建议定位日志一律使用idea*.logGlob mtime 排序兼容轮转与多实例IDE Starter 测试按productCode-buildNumber/testName/log/目录直达本地/CI 都要匹配常规测试从共享system/test/testlog/idea*.log中按Started a test/finished successfully|failed标记切分JUnit 4 或无 application context 的测试手动用LOG.info输出等价的开始/结束标记保持协议一致便于统一解析工具复用。【免费下载链接】intellij-communityIntelliJ IDEA IntelliJ Platform项目地址: https://gitcode.com/GitHub_Trending/in/intellij-community创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 IntelliJ 平台测试日志定位与解析：idea.log 轮转、IDE Starter 目录与 LogTestName 标记协议
IntelliJ 平台测试日志定位与解析idea.log 轮转、IDE Starter 目录与 LogTestName 标记协议【免费下载链接】intellij-communityIntelliJ IDEA IntelliJ Platform项目地址: https://gitcode.com/GitHub_Trending/in/intellij-community本文讲解 IntelliJ IDEA / IntelliJ Platform 测试框架中日志文件idea.log的定位与解析方法覆盖日志轮转命名规律、IDE Starter 测试与常规非 Starter测试两类日志路径、LogTestName标记协议以及配套的 Python 辅助函数。读完本文你将掌握在测试运行后快速找回最新日志、按测试方法切分共享日志并能在 Notebook 或脚本中自动化分析测试日志的完整实操方案。idea.log 的轮转机制永远用 Glob 而非固定文件名IDE 与测试运行期间产生的日志统一写入idea.log。随着日志增长该文件会轮转旧的分段被命名为idea.1.log、idea.2.log依此类推数字越大越旧。因此绝不能硬编码idea.log这个固定文件名——最新的日志可能正躺在idea.1.log甚至更后面的分段里。正确做法是使用 Glob 模式idea*.log匹配同一目录下的全部日志分段按文件修改时间mtime排序取 mtime 最新的文件即为当前活跃日志若要按时间顺序重放历史则按 mtime 升序拼接。这一约定同时适用于下面的 IDE Starter 测试与常规测试两类场景。IDE Starter 测试每个测试独占一个日志目录IDE Starter 是平台用于启动 IDE 实例并运行集成测试的框架。它会把每个测试的日志写入一个专属目录路径模板为repo/out/ide-tests/tests/productCode-buildNumber/testName/log/idea*.log各段含义路径段含义repo仓库根目录例如 intellij-community 检出目录out/ide-tests/testsIDE Starter 测试输出根目录productCode产品代号例如IUIntelliJ IDEA Ultimate、ICCommunitybuildNumber构建号本地运行为LOCALCI 上为数字构建 IDtestName测试名称直接映射为一个独立目录log/idea*.log该测试实例的日志文件含轮转分段由于buildNumber在本地与 CI 上取值不同检索时必须对两者都做匹配例如用IU-*形式的 Glob。因为每个测试名映射到自己的目录IDE Starter 场景下不同测试的日志天然分离——不需要任何 marker 解析直接按目录取文件即可。find_log按 mtime 定位最新测试日志配合上述目录结构可用如下 Python 函数定位某个测试的最新日志from pathlib import Path def find_log(test_name: str) - Path: matches sorted( (repo_root / out / ide-tests / tests).glob( fIU-*/{test_name}/log/idea*.log ), keylambda p: p.stat().st_mtime, ) if not matches: raise FileNotFoundError( fNo idea.log found for test {test_name}. Run the test first, then re-execute this cell. ) path matches[-1] # most recently modified print(f{test_name}: {path}) return path实现要点Glob 模式IU-*/{test_name}/log/idea*.log同时覆盖IU-LOCAL/...与IU-数字构建号/...两种目录按st_mtime排序并取matches[-1]对应按 mtime 排序后取最新文件的轮转处理原则日志缺失时抛FileNotFoundError是有意为之测试必须先运行、产生日志Notebook 才能做后续分析。缺失日志是硬性前置条件而不是可选的降级模式因此用异常作为明确信号避免静默失败导致下游分析基于空数据。常规非 Starter测试共享日志 LogTestName 标记普通单元/集成测试不经过 IDE Starter日志写入共享的系统日志目录system/test/testlog/idea*.log关键约束是日志不会在测试方法之间清空——一次测试运行中的所有测试共享同一组轮转文件。此时要从共享日志中抽取某个测试的记录必须依靠LogTestName标记进行分界。标记格式如下 Started a test: ClassName::testMethodName ...log lines for this test... The test finished successfully: ClassName::testMethodName 测试开始标记Started a test: ClassName::testMethodName结束标记The test finished successfully: ClassName::testMethodName失败时为The test failed: ...。LogTestName 的注册方式LogTestName全名com.intellij.testFramework.junit5.LogTestName文档所述是 JUnit 5 的InvocationInterceptor。启用方式有两种显式扩展在测试类上添加ExtendWith(LogTestName::class)传递注册若测试类已使用TestApplicationLogTestName可能已被其传递性地注册无需重复添加。如果LogTestName不适用例如 JUnit 4 测试、没有 application context 的场景则需要手动打标记在测试方法体首尾各加一次LOG.info调用输出与上述格式一致的开始/结束文本以便后续按同一协议解析。extract_test_section按标记切出单个测试的日志拿到共享日志全文后用如下函数切出指定测试的日志区间import re def extract_test_section(log_text: str, test_display_name: str) - str: Return log lines between the Started and finished/failed markers for one test. start re.search(rStarted a test: re.escape(test_display_name), log_text) if not start: return tail log_text[start.end():] end re.search( rThe test (?:finished successfully|failed): re.escape(test_display_name), tail, ) return tail[:end.start()] if end else tail解析要点re.escape(test_display_name)测试名如ClassName::testMethodName含::等正则元字符必须转义后再拼入模式避免误匹配开始标记缺失时返回空串说明日志里没有该测试的记录可能未运行或日志已轮转丢失结束标记同时匹配成功与失败(?:finished successfully|failed)保证无论测试结果如何都能正确切出区间若日志截断导致找不到结束标记则返回从开始标记到文件末尾的全部内容。仓库内的日志路径配置佐证在 intellij-community 仓库中可以找到与上述机制对应的底层配置bin/idea.properties 中预留了idea.log.path${idea.system.path}/log的注释示例说明日志目录默认位于 IDE 系统目录system下可自定义路径——这正是常规测试日志system/test/testlog/idea*.log中system段的来源IdeLauncher.kt 在启动 IDE 时通过-Didea.log.path${environmentPaths.logFolder}显式指定日志目录说明 IDE Starter 这类启动器会为每个实例注入独立的日志路径从而支撑每个测试独占一个日志目录的目录结构。结合文档与这两处源码可以确认日志目录是通过idea.log.path系统属性控制的Starter 测试与常规测试的差异本质上是该属性被指向了不同目录专属目录 vs. 共享system/test/testlog而共享目录场景下则必须依赖LogTestName标记协议做日志分界。实践建议定位日志一律使用idea*.logGlob mtime 排序兼容轮转与多实例IDE Starter 测试按productCode-buildNumber/testName/log/目录直达本地/CI 都要匹配常规测试从共享system/test/testlog/idea*.log中按Started a test/finished successfully|failed标记切分JUnit 4 或无 application context 的测试手动用LOG.info输出等价的开始/结束标记保持协议一致便于统一解析工具复用。【免费下载链接】intellij-communityIntelliJ IDEA IntelliJ Platform项目地址: https://gitcode.com/GitHub_Trending/in/intellij-community创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考