地址、邮箱、公司抬头、客服模板句、报税编号——这些内容每次都要一个字一个字敲,是办公场景里最典型的浪费。TypeText 就是干这个的。
基本写法
-- 把常改的部分提到最前面
local ADDRESS = "北京市海淀区中关村大街 1 号 A 座 1201"
TypeText(ADDRESS)
编译期它会被展开成一串按键动作——TypeText 不是运行时逐个字符打出来的,而是编译时就把文本编码成 Alt + 小键盘(或 Option + HEX)序列。这一点决定了它的适用范围,后面细说。
Windows:默认 GBK,用 Alt + 小键盘
TypeText("你好") -- 等价于 mode="gbk"
TypeText("你好😀", "unicode") -- Emoji 走 Unicode 码点
GBK 覆盖常用汉字,编码短、按键次数少;
Emoji、生僻字、日文假名之外的特殊符号,GBK 编不了,必须显式给 "unicode"。
前提条件,三条缺一不可:
小键盘可用。Alt + 小键盘数字是靠 num0–num9 打的,笔记本没有独立小键盘、NumLock 关着的,全部打不出来;
输入法处于英文 / 直连状态。中文输入法开着的时候,Alt + 数字可能被输入法截走;
目标程序接受 Alt 组合键。极少数程序把 Alt 当菜单键,会在输入过程中弹出菜单栏。
macOS:默认 Unicode,用 Option + HEX
TypeText("你好") -- 等价于 mode="unicode",展开为 Option + HEX
用之前必须先在 系统设置 → 键盘 → 输入法 / 输入源 里启用并切换到 Unicode Hex Input。
macOS 不支持 mode="gbk"——GBK 机内码输入属于 Windows 输入体系,在 Mac 上没有对应机制。
长度:这是最容易踩的坑
因为编译期展开,文本长度直接换算成按键次数。一个汉字在 GBK 下是 2 字节,每个字节展开成「Alt + 4 位数字 + 松开」,大约 6 次按键动作。
粗算一下:
文本长度
大致按键动作数
实际耗时
10 个汉字
约 120 次
1–2 秒
50 个汉字(一段地址)
约 600 次
6–10 秒
500 个汉字(一篇文章)
约 6000 次
一分钟以上,且极易被目标程序截断
所以:
适合:地址、邮箱、模板句、编号、十几到几十个字的内容;
不适合:整段落、整篇文章。真要批量输入正文,用系统的输入法自定义短语或者剪贴板,不要用 TypeText。
超过 100 字就该重新想方案了。
一个实用的组合:替换而不是追加
输入前先全选,能保证结果是替换而不是拼在后面:
local TEMPLATE = "您好,您反馈的问题我们已收到,会在 24 小时内处理。"
KeyDown("lctrl")
KeyTap("a")
KeyUp("lctrl")
Delay(80) -- 等目标程序完成全选
TypeText(TEMPLATE)
Delay(80) 这一步不要省。全选是异步的,紧接着就输入,前面几个字符可能打进旧选区。
现场排查
现象
原因
打出来是一串数字,不是文字
小键盘 NumLock 关着,或输入法处于中文状态
只有前几个字进去,后面丢了
目标程序有输入长度或速率限制,把 TypeText 拆成几段、中间加 Delay
弹出了程序菜单
目标程序把 Alt 当菜单键,换用剪贴板方案
Emoji 变成问号或方块
没给 "unicode",GBK 编不出来
Mac 上完全没反应
没切到 Unicode Hex Input 输入源
什么时候不该用它
如果目标是「把一段固定内容填进某个字段」,还有一个更省事的思路:能不能让目标软件自己读取? 比如表格的自动填充、Word 的自动图文集、输入法的自定义短语。这些方案不占宏时长,也不受输入法状态影响。
宏的价值在于跨软件、跨界面、目标程序没有现成功能时的那一下。能用软件自带功能解决的,优先用自带功能。