Verse 编译报错怎么读:文件、行列、错误码

一、报错的三段式

在 UEFN 里按 Ctrl+Shift+B 编译失败时,Verse 按钮会变成红色停止图标,点错误提示里的「See Errors」会打开 Message Log 面板,里面列着全部错误。挑一条出来看,它长这样:

my_door.verse(10,9, 10,13) : Verse compile error vErr:S54 : Unknown identifier `Prnt`.

它分三段,从左往右读:

习惯之后,读一条报错只要三秒:哪个文件第几行 → 编译器在抱怨哪个词 → 它抱怨的是哪一类问题。在 Message Log 里双击这一条,UEFN 会把你送到那一行那一列,光标就停在出错的字符上。

二、新手最常撞的五条

下面五条覆盖了绝大多数「第一周」的编译失败。描述文本会随版本微调,但意思是稳定的。

1. Unknown identifier —— 「这个名字我不认识」

大意:你用了一个编译器没见过的名字。三种成因,按概率排序:

• 拼错或大小写错。Verse 区分大小写:Print 不等于 print,OnBegin 不等于 Onbegin。蓝图的右键搜索框会模糊匹配、帮你纠正,文本编辑器不会;
• 忘了 using。名字确实存在,但住在一个你没请进来的库里——Print 要 using { /UnrealEngine.com/Temporary/Diagnostics },Sleep 要 using { /Verse.org/Simulation }。这一条几乎是每个人的第一滴血;
• 名字出了作用域。声明在某个缩进块里的常量,块一结束就不认得了。

2. Unknown member —— 「这个东西上没有这个成员」

大意:名字本身认得,但你拿它去点一个它没有的东西,比如 MyDoor.Opne()。翻译到蓝图语境就是:你从一个对象引脚上拉出来,搜一个这个类根本没有的函数。定位办法和上一条一样——先怀疑拼写,再去 Verse API 文档里确认这个类到底有哪些成员。

3. 重写对不上号 —— <override> 相关

这一类有两个方向,报错描述不同但根因是同一个:你写的签名和父类里那份对不上。

• 你带了 <override>,但父类里没有可以被重写的同名同签名函数。多半是函数名敲错(OnBegin → OnBegan),或者漏了 <suspends> ——签名少一块徽章,编译器就认为这是另一个函数;
• 你确实在重写父类的东西,却没写 <override>。编译器不接受「悄悄覆盖」,要求你显式申报。

撞到这一类,别急着改逻辑,先把 OnBegin<override>()<suspends>:void = 这一行和正课里的写法逐字比对一遍。

4. 失败上下文 —— 「这个判断必须放在允许失败的地方」

大意是:这个可能走不通的表达式,必须出现在一个允许它走不通的位置(英文里会出现 failure context 这个词)。新手撞到它,九成是忘了写 set:你想改一个变量,写了 Score = 100,但 Verse 里单个 = 是比较,不是赋值——于是这行变成了一个判断,而判断不能光秃秃地站在那儿。

解法:改值一律写 set Score = 100。这条报错的完整故事在第 8 课和第 12 课。

5. 缩进与语法 —— 「这儿不该出现这个」

Verse 用缩进表达归属,所以缩进错了就是语法错了。最常见的两种:该缩进的行没缩(函数体和函数声明齐平)、以及混用 Tab 和空格——肉眼看着对齐,编译器看到的是两种不同的字符。VS Code 默认 4 空格,别去动它。这类报错的描述往往比较干(「Expected …」之类),但位置那一段永远准确,顺着行号看缩进就行。

还有一条不算错误但值得知道:编译通过不代表运行时不会出事。Verse 另有一套运行时错误上报机制,那是另一个话题,见文末来源。

三、定位手法:四条经验

• 永远先修第一条。Verse 一次编译整个项目,一个真错误经常连锁生出七八条派生错误。修掉列表最上面那条再重编,后面的往往一起消失。盯着第五条改,大概率是在改一个根本不存在的问题;
• 报错文件可能不是你正在改的那个。这一点和蓝图很不一样:蓝图 Compile 只管当前资产,Verse 的 Build 一次编译项目里所有 .verse 文件。先看清位置那一段的文件名,再决定打开哪个文件;
• 双击报错跳过去,别手动数行。Message Log 里双击一条,UEFN 会把光标送到那一行那一列。行列信息是精确到字符的,值得信任;
• VS Code 不红 ≠ 编译通过。VS Code 的 Verse 扩展做的是语法提示,真正的编译发生在 UEFN 按下 Ctrl+Shift+B 的那一刻。保存不是编译。

四、和蓝图的 Compiler Results 面板对照

蓝图当然也会编译失败,只是你可能没太把它当回事——因为它错得「有画面」。

习惯之后你会发现文本报错其实更好用:它可以被复制、被搜索、被贴进论坛帖子、被丢给 AI。蓝图里那个圈红的节点,你只能截图。

五、来源

本文整理自 Epic 官方文档:

• 官方文档:Verse Language Quick Reference ↗
• 官方文档:Failure in Verse(失败上下文)↗
• 官方文档:Verse Runtime Error Reporting(运行时错误,与编译错误是两回事)↗