1. 先说清楚为什么我非要把串口log“强制”自动保存干嵌入式、单片机、物联网调试这行的朋友应该都有过这种经历拿着一块开发板接上USB转TTL模块打开某个串口调试助手对着设备一顿操作调了一下午终于把问题复现出来了。结果呢日志刷屏刷得太快往上翻翻了半天好不容易定位到关键报错信息手一抖清屏了。或者更惨——设备重启、断电、电脑蓝屏、串口被其他软件占用一整天的工作记录就这么没了只能重头再复现一遍。我自己踩过最大的一个坑是在调试一块4G模组的通信协议时设备每隔几分钟会打印一次异常心跳包。当时用串口手工具手动复制日志复制了几十次漏了好几段最后分析数据时发现缺失了关键的报错序列导致我整整白查了两天。从那以后我就下定决心凡是接串口调设备第一件事就是先把日志自动保存打开不管后面用不用得上先落盘再说。MobaXterm这个工具很多人对它的印象是“Windows下连Linux服务器的神器”。它确实集成了SSH、FTP、X11转发这些功能但很多人忽略了它在串口调试上的能力。MobaXterm自带串口会话功能能直接连接COM口也就是你电脑上的USB转串口比如常见的CH340、CP2102芯片方案而且它的日志自动保存能力比传统串口调试助手强太多——支持颜色保留、时间戳、自动文件名、按会话隔离最关键是它是后台自动落盘的不需要你手动点保存。这篇文章我直接把自己平时在Windows下用MobaXterm做串口日志自动保存的3套方案完整写出来。第一套适合新手点几个设置就行第二套适合经常要远程调试Linux开发板的人第三套适合喜欢轻量命令行的人。三套方案各有取舍我会把配置参数、适用场景、踩坑点都讲透你照着抄就能用。2. 方案一MobaXterm自带日志功能两分钟配置好这是最推荐入门使用的方法因为MobaXterm把日志功能做成了一个可勾选的开关不需要额外安装任何插件也不用写脚本。2.1 新建串口会话前先把全局日志参数配好打开MobaXterm主界面先别急着连串口点击顶部菜单栏的Settings设置然后进Configuration配置。在左侧导航找到Terminal选项卡里面有一个Logging区域这里就是所有日志保存的全局默认参数。你需要确认以下几个选项Log terminal output勾选这个终端输出才会写入文件。如果不勾选后面一切白搭。Log type建议选Plain text纯文本。另一个选项是ANSI color能把终端里的颜色码以转义序列形式存进文件。说实话ANSI color模式在回看日志时很痛苦里面全是\x1b[31m这种字符可读性极差所以我默认选纯文本。Log file name这里支持宏变量你可以用%Y-%m-%d_%H-%M-%S这种日期时间占位符。比如写成D:\serial_logs\%Y-%m-%d_%H-%M-%S.log那么每次新建会话都会生成一个以当前时间命名的文件不会互相覆盖。Save logs on demand这个不建议勾。它的意思是“你按一下按钮才保存”这就又回到手动保存的老路上了违背了我们全自动的初衷。Append logs to same file勾选的话所有会话的输出都堆积到同一个文件末尾不勾选的话每个会话单独一个文件。我建议不勾选每回调试一个独立主题就让它生成独立文件后续回看归档都好处理。配置好之后点OK保存。以后每个新建的串口会话都会自动套用这个日志规则。2.2 串口会话级别再检查一遍参数在MobaXterm主界面点击Session会话图标在弹出的窗口里选择Serial选项卡。这里填入你实际的串口参数Serial port选择COM口编号Baud rate选择波特率其余如数据位8、停止位1、校验位None一般保持默认即可。关键点来了很多人在这一层找不到日志设置。你需要点击下方那个Advanced Serial settings按钮展开之后会多出几个选项其中就包括Log filename。这里可以单独指定当前这个串口会话的日志文件名覆盖全局设置。我个人的习惯是全局设置只负责“开启日志”这个总开关具体文件名放在会话级别配置。因为不同设备的调试记录想分开放比如GPS模块的log放一个目录4G模组的放另一个目录互不干扰。在会话级别写路径时可以用相对路径也可以写绝对路径建议写绝对路径MobaXterm对相对路径的解析在某些版本下不太稳定。注意MobaXterm的串口会话日志功能在旧版本比如v10.x里藏在会话建立之后右键标签页的Edit session里。如果你找不到Advanced Serial settings右键左侧会话列表里的会话选择Edit session同样能看到日志相关配置。2.3 实测效果与常见误区配置好后正常打开串口会话MobaXterm窗口下方状态栏会看到一个小红点或者日志文件名显示说明已经在记录了。此时设备输出的所有内容会实时写入到你指定的log文件里。我实测过很多次这个记录过程有几个特点写入是实时的不是缓存到内存等退出时才flush所以你大可放心设备死机、电脑断电之前的内容基本已经在磁盘上了。日志文件在Windows下编码默认是UTF-8。如果你的设备输出的是GBK/GB2312中文用记事本打开可能乱码。没关系用VS Code或者Notepad打开时手动切换编码即可。如果中途改了波特率MobaXterm不会自动重新适配也不会在log里标注“波特率已更改”这个需要你自己在测试时注意。方案一最省事但有个限制它只能在MobaXterm这个窗口界面里工作。如果你同时想干别的比如一边看log一边在另一个终端敲命令一旦串口会话被误关或者软件崩溃日志写入也会中断。对于长期运行的设备比如连续压测几天几夜会存在风险。这时候就需要方案二了。3. 方案二Linux screen logfile把日志留在设备端这个方法适合什么场景就是你的开发板或设备本身就是Linux系统你用MobaXterm的SSH功能登录到设备上设备的串口比如/dev/ttyUSB0、/dev/ttyAMA0需要你通过命令来读取。这种情况下日志已经不属于MobaXterm的终端界面而是由Linux系统里的工具在管理所以我们要在Linux端实现自动保存。3.1 一条命令搞定screen的log功能Linux下读取串口最常用的命令之一就是screen。它的本职工作是一个终端复用器但自带一个很实用的参数叫-L意思是把终端所有输出写入到日志文件里配合-Logfile指定路径。连串口的完整命令是screen -L -Logfile /var/log/serial_ttyUSB0.log /dev/ttyUSB0 115200拆开解释一下-L开启日志记录。-Logfile指定日志文件的绝对路径。如果不指定默认在当前目录生成一个screenlog.0文件。/dev/ttyUSB0串口设备名如果用的是CH340方案通常是ttyUSB0或ttyUSB1如果是树莓派板载串口一般是ttyAMA0或ttyS0。115200波特率这个必须跟你的设备一致不然全是乱码。运行后设备输出的所有内容都会实时写入/var/log/serial_ttyUSB0.log。想退出串口查看界面时按Ctrl A再按K然后按Y确认杀掉会话。日志文件会保留在设备里。实际使用中我踩过几个坑需要单独说一下如果提示screen: command not found说明系统没装screen。Devuan/Ubuntu/Debian系执行sudo apt install screen就能装。但要留意嵌入式Linux如BusyBox环境通常没有screen命令那么这条方案就要换成busybox自带的microcom工具不过microcom本身不直接支持记日志需要配合管道处理就没那么方便了。每次CtrlA然后按K退出时一定要等日志文件size不再变化了再拷贝。有时候文件系统和进程之间还有缓冲立刻scp拷贝会得到截断的文件。建议退出后等两秒然后再拷贝。日志写到/var/log目录需要root权限。不想开root的话把路径改到用户目录比如~/serial_logs/$(date %Y%m%d).log这种写法也可以。3.2 大招用空白输出自动滚动配合cron做日志切割screen的log功能默认是“一个文件写到地老天荒”如果设备持续运行几个月log文件会膨胀到几个GB甚至几十GB到时候打开文件都费劲。所以在方案二里我习惯配合logrotate做日志切割。在设备的/etc/logrotate.d/目录下新建一个配置文件内容类似/var/log/serial_ttyUSB0.log { daily rotate 7 compress missingok notifempty copytruncate }这个配置的意思每天切割一次保留7份历史文件旧的压缩成.gz日志文件不存在时跳过空文件不切割copytruncate参数很关键——它先复制一份当前log再清空原文件这样就算screen进程还在向原文件写数据也不会报错。配置好之后logrotate的切割是自动触发的不需要人工干预。每天凌晨你得到的是一个带日期的历史归档比如serial_ttyUSB0.log-20250315.gz今天运行产生的数据还在主文件里。这个方案对“长时间、无人值守”的调试场景非常友好。3.3 为什么推荐screen而不是cat直接重定向有的朋友会问我直接执行cat /dev/ttyUSB0 log.txt 不也一样吗从“能记录”这个角度确实一样但差别在于cat log.txt是纯输出重定向你没法实时看屏一旦想看当前输出状态就得另开一个终端去tail。screen提供了一个可视化交互界面你能看到输出也能用scrollback翻页查看历史用Ctrl A然后Esc进入复制模式再翻页。最重要的是screen支持detach当你需要暂时离开终端按Ctrl A再按D会话会在后台继续跑串口数据不会断。这在你需要临时腾出MobaXterm窗口去处理其他任务时太有用了。这里补充一个小知识点MobaXterm本身连接串口时是可以直接保存日志的但它的实现是“你本地Windows的一个窗口连到了串口”。而方案二把日志存到了Linux设备端两边都有独立的记录文件等于做了一层双保险。我实际调试时经常两边同时开着本地留一份设备端留一份哪边出问题都有备份。4. 方案三Minicom 脚本定时导出轻量无依赖第三种方法适合那些不喜欢screen那一堆快捷键、也不喜欢GUI设置的人。minicom是最老牌的Linux串口工具了基本上所有Linux发行版的软件源里都有安装也方便sudo apt install minicom4.1 minicom的基础配置与日志开启先用minicom -s进入设置模式选择Serial port setup在里面把串口设备和波特率填对A对应串口设备路径比如/dev/ttyUSB0E对应波特率可以手动输入比如115200确认硬件流控Hardware Flow Control改为No否则有时会卡住设置完成后选“Save setup as dfl”保存默认配置。以后直接执行minicom就会用这套参数连串口。minicom的日志保存设置默认是不开启的。在运行界面里按Ctrl A然后按L它会提示你输入一个日志文件名。输入完成后minicom就会开始把所有输出写入这个文件。这个方法有个明显的好处日志文件是即时落盘的。minicom写日志用的是fprintf配合缓冲虽然没有做到每次字符都flush但你在设备端随时tail文件基本能实时看到新内容。如果你用screen的log模式数据是分批写入的实时tail时往往有一小段延迟。4.2 脚本化自动记录自动加时间戳minicom的日志功能虽说简单但有一个痛点每次按Ctrl A然后按L手动输入文件名还是麻烦。我习惯写一个小脚本把“启动minicom并带出日期文件名”的逻辑封装起来#!/bin/bash LOG_DIR$HOME/serial_logs mkdir -p $LOG_DIR LOG_FILE$LOG_DIR/$(date %Y%m%d_%H%M%S)_minicom.log exec minicom -D /dev/ttyUSB0 -b 115200 -C $LOG_FILE把这段保存成一个run_minicom.sh然后chmod x run_minicom.sh。以后只要执行这个脚本minicom就会自动启动日志文件自动按当前时间命名存放在~/serial_logs目录下。这里用exec替换当前shell进程执行minicom好处是以后你CtrlA再X退出minicom时整个脚本进程也会一并退出不会留下后台僵尸进程。4.3 minicom日志场景的两个隐藏技巧minicom的日志记录有个小毛病它把整个终端的输出包括一些控制字符都原样写入文件了。比如说你在minicom界面里按了上下键浏览历史这些按键对应的转义序列也会混进log文件里。没关系我们后期处理一下就行sed -i s/\x1b\[[0-9;]*[a-zA-Z]//g $LOG_FILE sed -i s/\x1b\][^\x07]*\x07//g $LOG_FILE这两条sed命令第一条干掉常见的ANSI颜色/光标移动转义序列第二条干掉操作系统命令序列OSC跑完再打开log文件就干净多了。另一个技巧是minicom的日志文件中每行末尾可能是\r\n而不是\n这在后续用Python脚本分析log时可能导致解析问题。处理方式也很简单用Python读的时候带上newline或者先统一替换一下\r\n为\n即可。5. 三套方案横向对比与我的选型建议很多第一次接触串口日志自动保存的朋友看了三种方案可能会有些迷惑。我用一张表格把它们的核心差异列出来方便你根据自己的实际情况来选。对比维度方案一MobaXterm GUI方案二screen logfile方案三Minicom 脚本适用平台Windows本地MobaXterm内远程Linux设备通过SSH已登录Linux或本机有minicom配置难度低点几个选项中需熟悉screen快捷键中高需配置minicom参数日志落盘位置本地Windows磁盘远程Linux设备磁盘Linux本地磁盘是否支持日志切割不支持需自己定时清理可以配合logrotate手动移动或写脚本实时性较好基本实时写入分批写入略有延迟基本实时断线/崩溃风险软件崩溃会中断screen后台运行更稳依赖终端关了就断适合场景快速调试、临时记录长期压测、无人值守轻量环境、无GUI依赖5.1 如果你只想要最简单的方法那就直接用方案一。打开MobaXterm全局设置里勾上Log terminal output路径填好完事。这个方法最适合Windows下临时接一块板子快速看输出、留个底。它的弱点是切割和归档能力差日志文件会越来越大。我的做法是每次调试前手动给log文件名加上日期比如D:\logs\20250315_uart.log这样同一个文件里不会有跨天的数据搅在一起。5.2 如果你要长时间挂机测试那就用方案二。把screen跑在后台配合logrotate做切割哪怕你关了MobaXterm也没关系设备端照样在记录。等你过两周再打开看归档文件都按天压缩好了拿下来慢慢分析。这个方案也是我目前做连续可靠性测试时的首选。5.3 如果你的设备环境非常简陋没有screen也没有systemd甚至连Python都不想装那就用方案三。minicom在BusyBox环境里可能没有但在标准的Debian/Ubuntu系统里一定装得上脚本简单无依赖日志文件也干净。5.4 我的实际选择组合说下我真实的调试习惯本地Windows开着MobaXterm的GUI串口会话开日志保存作为现场记录同时SSH连进Linux设备在设备上挂一个screen会话把日志写到设备端的/var/log目录配好logrotate。这样做的原因是就算我在本地乱操作导致MobaXterm崩了设备端的数据仍然在而且不依赖网络稳定性。6. 绕不开的坑与排查技巧不管用哪种方案串口日志保存这块始终有几个高频问题我每个都实际遇到过整理成速查表方便你排查。故障现象可能原因解决办法MobaXterm连不上COM口CH340/CP210x驱动没装好设备管理器看是否识别为COM口没有就装对应驱动比如CH340芯片方案要安装ch340串口驱动日志文件是空的Log terminal output没勾选或路径无写权限取消勾选Save logs on demand检查磁盘目录是否真实存在日志内容全是乱码波特率不匹配或设备为8E1等不规则格式核对设备的实际波特率、校验位、数据位逐项调整log文件打开是乱码中文UTF-8与GBK编码不匹配用VS Code/Notepad切换编码打开日志文件一直不涨串口数据进了内核缓冲但没被工具读取检查连接的USB转TTL模块上的TX/RX是否接对板上是否共地screen退出后文件不完整文件系统尚未flush不要马上杀进程用sync命令刷盘再拷贝MobaXterm退出时日志丢失软件崩溃导致缓冲区丢失尽量用正常流程关闭会话而不是任务管理器强杀6.1 关于log文件编码的一个补充调试设备时很多国产模块比如GPS、4G模组会直接输出中文提示。MobaXterm默认保存为UTF-8是没问题的但如果你用老式串口助手生成的日志GB2312做对照分析两边的编码可能不一致。我的经验是在分析时统一用VS Code打开右下角手动切换文件编码看到不乱码就算好。6.2 关于USB转TTL模块的坑如果你发现日志数据忽断忽续或者MobaXterm提示“Access denied”排查顺序是先拔掉USB线重新插确认没有其他软件占用串口再检查模块本身CH340这类便宜模块在高速率大流量下偶尔会有丢包现象换成带屏蔽的成品线能缓解。日志保存本身不会导致丢包但如果串口收到的数据本身断了log里自然对应少一段。6.3 关于MobaXterm版本差异MobaXterm的免费版Home Edition和付费版在日志功能上是一致的没有阉割。但有一点要注意免费版在某些系统上会有“标签页数量限制”和“会话数量限制”的提示不影响单个串口日志保存。另外新版MobaXterm的界面语言为英文如果想改成中文网上有汉化教程但建议还是用英文原版因为汉化补丁偶尔会导致设置界面无法打开遇到这种情况不要慌重装原版即可。7. 最后分享一点我的经验心得从最开始手动复制日志到现在三套方案随手切换最直观的感受就一句话日志保存这步越自动化调试效率越高。你永远不知道一个bug什么时候会复现但如果你随时都有一份完整日志在手复现问题、定位根因的速度会快好几倍。我自己的习惯是每次接一块新设备或者新板子第一件事不是打开调试助手而是先把日志目录和命名规则定好。宁可这轮调试没任何问题日志文件只是个空文件也不要等到出问题才发现自己什么记录都没留。哪怕是一模一样的代码不同批次硬件上的表现都不一样有日志才有对比有对比才能定位变量。这套思路并不仅限于串口日志很多类似的电脑端日志保存也适用。只要记住“先落盘再说”这个原则你会发现很多调试焦虑都会消失。希望这篇文章能帮你省掉那些因为日志丢失而被迫重来一遍的工作量。