TinyRetroPad编译报A2026错误?winextra.inc一行改动的快速修复技巧
TinyRetroPad编译报A2026错误?winextra.inc一行改动的快速修复技巧
TinyRetroPad 是一个用 x86 汇编写成的 Notepad 风格 Windows 文本编辑器,完整源码只有约 2.5 KB,用 MASM + Crinkler 编译。很多新手在本地编译 TinyRetroPad 时会撞上 MASM 的 A2026 错误(error A2026: constant expected),其实它不是你的代码问题,而是新版 MASM 与 masm32 自带头文件 winextra.inc 的语法不兼容——只需改动其中一处 dup 写法就能解决。本文带你快速定位并修复这个报错。
错误现场:A2026 错误长什么样
运行编译后,如果输出中出现下面这两行,就是典型的 A2026 错误:
C:\masm32\include\winextra.inc(11052) : error A2026:constant expected
C:\masm32\include\winextra.inc(11053) : error A2026:constant expected
注意两个细节:
- 报错位置在 masm32\include\winextra.inc,而不是 trpad.asm 本体;
- 错误号固定为 A2026,含义是"期望一个常量"。
这说明问题出在 MASM 解析头文件时,把某个表达式当成了非法常量。
报错根源:新版 MASM 对 dup 方括号语法的解析变化
A2026 的根源在 winextra.inc 里的 STD_ALERT struct 定义(约第 11052 行附近)。masm32 的旧写法用 方括号 包裹 dup 的重复次数:
STD_ALERT struct
alrt_timestamp dd ?
alrt_eventname WCHAR [EVLEN + 1] dup(?)
alrt_servicename WCHAR [SNLEN + 1] dup(?)
STD_ALERT ends
新版 MASM(项目使用的版本为 14.44.35224.0,见 README.md 中的说明)对这种"方括号 + 表达式 + dup"的组合解析更严格,会直接报 A2026。
快速修复:winextra.inc 一行改动
打开 masm32 安装目录下的 include\winextra.inc,找到 STD_ALERT struct 定义,把两行里的 方括号 [ ] 改成圆括号 ( ) 即可:
STD_ALERT struct
alrt_timestamp dd ?
alrt_eventname WCHAR (EVLEN + 1) dup(?)
alrt_servicename WCHAR (SNLEN + 1) dup(?)
STD_ALERT ends
前后对比,唯一的差异就是:
| 修改前 | 修改后 |
|---|---|
WCHAR [EVLEN + 1] dup(?) |
WCHAR (EVLEN + 1) dup(?) |
WCHAR [SNLEN + 1] dup(?) |
WCHAR (SNLEN + 1) dup(?) |
圆括号写法对 MASM 来说就是普通常量表达式,A2026 随即消失。改完保存,重新执行编译即可。
💡 提示:
winextra.inc属于 masm32 环境文件,修改它不会影响 TinyRetroPad 仓库本身,可以放心操作。
修复后重新编译 TinyRetroPad 的三个注意点
A2026 解决后,还有几个与编译环境相关的点,提前检查可以避免"下一个坑":
- LIBPATH 要匹配你系统的 Windows Kits 版本
构建脚本里默认使用了
C:\Program Files (x86)\Windows Kits\10\Lib\10.0.20348.0\um\x86这样的路径。如果你的系统版本号不同,请把/LIBPATH改成自己机器上实际存在的10.0.xxxxx目录。 - Crinkler 必须加入 PATH
TinyRetroPad 依赖 Crinkler 压缩器在构建时压缩二进制(成品约 2,476 字节),请确保
Crinkler.exe所在目录已加入系统 PATH,例如C:\utils\Crinkler.exe。 - 提前为杀毒软件设例外 使用 Crinkler 的程序很容易被 Windows Defender 误报,编译刚结束 EXE 就可能被直接删掉。建议把构建目录加入杀毒例外,再执行编译(详见 README.md 的 Important 部分)。
常见问题速查
问:改完 winextra.inc 还是报 A2026?
确认改的是 masm32 的 include\winextra.inc 文件本身,且两处方括号都改成了圆括号后保存。
问:为什么 README 里特意写了这个坑? 因为 MASM 版本差异会导致同样的构建脚本在不同机器上表现不一致,项目作者在 README.md 中把这段修复过程完整记录了下来,属于官方推荐的解法。
问:修好 A2026 后能直接用吗? 可以。编译通过后得到的 trpad.exe 就是那个完整的 Notepad 风格编辑器:File / Edit / Format / View / Help 全菜单、查找替换、打印、状态栏一应俱全。项目基于 Apache License 2.0 授权,见 LICENSE.TXT。
小结
- A2026 错误的本质:新版 MASM 与 masm32 头文件
winextra.inc的dup方括号写法不兼容; - 修复方式:把
STD_ALERT struct中两处方括号[ ]改成圆括号( ),一行改动即刻生效; - 顺手检查 Windows Kits 的 LIBPATH、Crinkler 的 PATH 和杀毒例外,一次编译直接通过。
