字符编码
路径：设置 → 终端 → 汉字节（Kanji）。接收与发送编码需与设备一致：Linux 设备通常为 UTF-8，部分国产网络设备为 GBK。两侧不一致时中文会显示为方块或问号。
使用文档
从建立第一条连接，到把巡检写成宏脚本。本文按实际使用顺序组织，命令与选项以 5.7.1 版界面为准；更细的参数说明可随时按 F1 查阅程序内置帮助。
快速上手
两种最常用的连接方式
启动 Tera Term 后会出现「新建连接」对话框，选择串口或 TCP/IP 即可开始。
连接串口设备
适用于交换机 Console 口、开发板 UART、工控设备的调试口。参数必须与设备手册一致，否则会出现乱码或无回显。
-
选择端口
在「新建连接」中选择「串口」，下拉列表会列出当前可用的 COM 端口。
-
设置通信参数
波特率（常见 9600 / 115200）、数据位 8、停止位 1、校验 None、流控 None 起步；长距离或高速传输再启用 RTS/CTS。
-
确认回显
按回车，若设备返回提示符即连接成功。无响应时先核对 TX/RX 是否交叉连接。
串口参数对照
| 波特率 | 9600 / 19200 / 38400 / 57600 / 115200 |
|---|---|
| 数据位 | 8（多数设备） |
| 停止位 | 1 |
| 校验位 | None / Even / Odd |
| 流控 | None / Xon-Xoff / RTS-CTS |
| 信号电平 | RTS / DTR 可单独切换 |
SSH 连接参数
| 主机 | 192.168.10.1 或域名 |
|---|---|
| 服务 | SSH2（默认端口 22） |
| 认证方式 | 密码 / 公钥 / 键盘交互 |
| 用户名 | admin |
| 私钥格式 | OpenSSH / PPK |
| 保存 | 可存为连接条目复用 |
连接 SSH 主机
适用于 Linux / Unix 服务器与支持 SSH 的网络设备。首次连接会提示确认主机密钥指纹，核对无误后再接受。
-
填写主机与服务
在「新建连接」中选择 TCP/IP，输入主机地址，服务选择 SSH2；端口非 22 时在地址后加
:端口号。 -
选择认证方式
密码认证直接输入；公钥认证需在「用户密钥」中指定私钥文件，支持 OpenSSH 与 PuTTY 的 PPK 格式。
-
保存为条目
勾选「保存设置」，下次可从
TERATERM.INI读取全部参数，避免重复填写。
常用设置
先解决这三项，体验差异最大
编码、换行与键盘映射是中文环境中最容易踩坑的三处设置。
换行与回车
路径：设置 → 终端 → 换行。粘贴多行命令时若出现重复执行或命令被截断，通常是 CR / LF 处理方式与目标系统不匹配，可切换为 CR+LF 或启用「粘贴时转换换行」。
复制与粘贴
Tera Term 的快捷键可在「设置 → 键盘」中自定义。默认可通过编辑菜单完成复制粘贴，也可使用 Ctrl+Insert 与 Shift+Insert，避免与终端中断信号冲突。
窗口与显示
- 尺寸：默认 80×24，可在「设置 → 终端 → 尺寸」调整为 132×43 等
- 滚动缓冲：加大行数以便回看长日志，占用内存随之上升
- 字体：推荐等宽字体（如 Cascadia Mono、Consolas）避免列错位
- 颜色：可选 16 色 / 256 色 / 真彩，配色方案可另存复用
日志与录制
- 文本日志：文件 → 日志，选择追加或覆盖，可附时间戳
- 二进制日志：保留控制序列，用于精确复现界面过程
- 录制回放：TTYRec 记录、TTYPlay 回放，按原始节奏还原
- 自动记录：可在宏中用
logopen控制起止范围
TTL 宏入门
把重复操作写成脚本
TTL（Tera Term Language）是内置的脚本语言，宏文件以 .ttl 保存，由 ttpmacro.exe 解释执行。语法接近 BASIC，学习成本低，配合等待与匹配可以稳定驱动交互式命令行。
最小可用示例
下面的脚本连接串口、发送一条命令、把回显写入日志，然后退出。把它保存为 demo.ttl，双击即可运行。
- 注释以分号
;开头，可独占一行 - 字符串使用单引号；变量无需声明类型
- 连接语句通过参数串指定串口或 SSH
- 等待用
wait匹配设备提示符，避免时序问题 - 日志用
logopen/logclose精确圈定范围
demo.ttl
; 连接串口并采集设备信息
connect '/C=3 /BAUD=115200'
wait 'Press any key'
sendln ''
wait 'login:'
sendln 'admin'
wait 'Password:'
sendln 'admin'
logopen 'C:\logs\uart-demo.log' 0 0
sendln 'show device info'
wait '#'
logclose
messagebox '采集完成' 'Tera Term'
sendln 'exit'
end常用命令速查
| 语句 | 作用 | 示例 |
|---|---|---|
| connect | 建立连接，参数串指定协议与端口 | connect 'host:22 /ssh /2 /auth=password' |
| sendln | 发送字符串并追加换行 | sendln 'show version' |
| send | 发送字符串，不追加换行 | send 'y' |
| wait | 等待指定字符串出现，可配合正则 | wait 'Password:' |
| pause | 暂停指定秒数 | pause 2 |
| logopen | 开始记录日志 | logopen 'C:\a.log' 0 0 |
| logclose | 结束记录 | logclose |
| if / endif | 条件分支，常与 result 搭配判断上一条命令结果 |
if result = 1 ... endif |
| while / endwhile | 循环结构，用于遍历主机或重试 | while i < 5 ... endwhile |
| strdim | 定义字符串数组 | strdim hosts 3 |
| messagebox | 弹出提示框，便于人工确认节点 | messagebox '完成' '提示' |
| end | 结束宏执行 | end |
batch-login.ttl · 按清单批量登录
; 从数组读取主机地址，逐个登录并采集配置
strdim hosts 2
hosts[0] = '10.0.0.11'
hosts[1] = '10.0.0.12'
i = 0
while i < 2
connect hosts[i]':22 /ssh /2 /auth=publickey /user=ops'
wait '$'
logopen 'C:\backup\'hosts[i]'.log' 0 1
sendln 'sudo show running-config'
wait 'end'
logclose
sendln 'exit'
i = i + 1
endwhile
end关于凭据：宏文件中的密码以明文保存。若需在共享环境中使用，建议改用公钥认证，并对 .ttl 文件设置 NTFS 访问控制，避免凭据随脚本扩散。
故障排查
四个高频问题
按出现频率排序。多数问题源于参数与设备侧不一致，而非程序本身故障。
中文显示为方块、问号或乱码
先确认设备输出使用哪种编码（UTF-8 或 GBK），再在「设置 → 终端 → 汉字节」中把接收编码设为同一值。若只有个别字符异常，可能是字体缺少对应字形，更换等宽字体即可。
串口打不开，提示端口被占用
同一 COM 端口在同一时刻只能被一个程序打开。检查是否已有串口助手、烧录工具或另一个 Tera Term 实例占用；关闭后重新连接。若设备通过 USB 转串口接入，重新插拔后端口号可能变化，需要在设备管理器中确认。
SSH 连接超时或被拒绝
依次排查：目标地址与端口是否可达（Test-NetConnection 主机 -Port 22）；设备是否启用 SSH 服务；防火墙或安全组是否放行；是否需要用代理（可配合 TTProxy 插件）。键盘交互认证失败时，改用密码或公钥认证。
全屏程序（如 top、vim）显示错乱
通常是终端类型与仿真能力不匹配。在「设置 → 终端 → 终端类型」中选择 xterm 或 vt100，并确保设备侧 TERM 环境变量与之一致。窗口尺寸也需足够，过小会导致换行错位。
