Motrix日志查看需分五步：一、按体系定位默认logs目录；二、用命令行筛选ERROR等关键信息；三、v1.7.0+可启用内置日志面板；四、便携版需检查aria2.conf中log=配置；五、日志格式为时刻戳、级别、模块、消息四段式。
如果无论兄弟们在使用Motrix下载经过中遇到任务异常中断、速度骤降或连接失败等难题，需定位具体错误缘故，则需直接查阅其生成的日志文件。Motrix将运行时的关键事件按时刻戳、级别和模块记录于本地日志中，下面内容为查看日志文件的多种技巧：
一、通过文件体系直接定位日志目录
Motrix默认将日志文件保存在其应用程序数据目录下的logs子目录中，路径因操作体系而异，且不依赖用户手动指定。该方式无需启动Motrix即可读取历史日志内容。
1、Windows体系：打开文件资源管理器，在地址栏粘贴并回车：%APPDATA%Motrixlogs
2、macOS体系：打开访达，按下Shift + Command + G，输入：~/Library/Application Support/Motrix/logs
3、Linux体系：打开终端，执行命令：ls ~/.config/Motrix/logs/
4、确认日志文件命名格式：所有日志文件均以YYYY-MM-DD.log形式命名，例如2026-04-22.log，最新日期对应最新日志。
二、使用命令行快速筛选错误信息
日志文件为纯文本格式，每行包含时刻戳、日志级别（如ERROR、WARN）、模块名及消息体。通过终端命令可高效提取关键线索，避免人工逐行扫描。
1、Windows（PowerShell）：在日志目录中执行：Get-Content .log | Select-String “ERROR”
2、macOS/Linux（终端）：进入日志目录后运行：grep –include=”.log” -r “ERROR” .
3、进一步限定范围：若仅需查看最近24小时内的错误，可结合find与grep：find . -name “.log” -mtime -1 -exec grep “ERROR” } ;
三、启用Motrix内置日志面板（需v1.7.0+）
Motrix自1.7.0版本起集成简易日志查看界面，可在图形界面中实时观察运行情形，适用于调试活跃下载任务或验证配置变更效果。
1、确保Motrix已启动并处于前台窗口
2、点击右上角菜单按钮（三个点图标），选择“开发者工具” → “日志”
3、面板顶部提供筛选控件：可按INFO、WARN、ERROR级别单独显示
4、滚动到底部可自动聚焦最新日志条目；点击某一行可高亮显示其完整上下文
四、检查便携版日志路径是否被重定向
若使用的是Motrix便携版，其日志路径可能已被修改为相对路径，不再位于体系默认位置。此时必须依据便携版启动脚本或Aria2配置中的显式定义进行查找。
1、打开便携版根目录下的extra/[platform]/x64/engine/aria2.conf文件
2、搜索关键词log=，确认其值是否为相对路径，例如：log=./data/logs/aria2.log
3、若存在该配置，则实际日志文件位于便携版U盘根目录的data/logs/文件夹内
4、同时检查Motrix主程序是否通过--log-path参数指定了独立日志路径，该参数优先级高于配置文件
五、解析日志条目结构示例
领会日志格式有助于快速识别难题源头。每条标准日志由四个字段构成，以空格分隔，顺序固定。
1、首段为ISO 8601格式时刻戳，例如：2026-04-23T14:22:05.189Z
2、第二段为日志级别，常见值包括：INFO、WARN、ERROR
3、第三段为模块标识符，如main（主进程）、aria2（下载引擎）、rpc（远程调用接口）
4、末段为描述性消息，含错误码时通常以[E001]等形式标注，例如：[E001] Failed to connect to RPC server at http://127.0.0.1:6800
