# 常见错误 在编写魔改脚本时，可能会出现一些常见的，有通用解的错误，在此列出名称、起因。 语法错误最好在 /ct syntax 检查出来，在游戏加载时加载脚本可能脚本有语法错误，却依旧尝试编译，导致又臭又长的也看不懂的字节码错误。有时候一个错误会导致很多别的错误。比如没导包的错误，可能会导致之后一堆 `any type is not supported` 错误。但是只有第一条错误 `cannot find XXX` 才是最重要的。而游戏聊天栏显示数量有限，第一条报错就顶掉了，所以报错请第一时间看日志。解决报错也请按照日志报错的顺序一个个解决，因为有可能后面的脚本是因为所依赖的脚本（如跨脚本引用）出了问题才报错，实质上没有问题，当前面的报错解决了，后面的报错也有可能一起解决了。 程序报错不是只是告诉你「我出问题了！」，而会或多或少告诉你哪里出错了以及报错的原因。若要成为一个合格的魔改人，学会看报错是一门必修课。报错分为编译时错误和运行时错误。 ## 编译时错误 该类错误一般可用 `/ct syntax` 发现，且报错相对比较简短。 `[INITIALIZATION][CLIENT][ERROR] script.zs:2 > ) expected` `[游戏运行阶段][游戏运行端][错误] 脚本名.zs:行数 > 报错原因` 告诉你哪个脚本的哪一行出现了什么错误。对于缺分号等语法错误，这个行数仅供参考，你应该在该行附近检查问题。 ### 语法错误 缺分号，括号不对称等。 示例： ```csharp // 缺少分号 // 讲真，这连插件语法检查都过不去... recipes.remove() ``` 报错： ```log [INITIALIZATION][CLIENT][ERROR] blah_blah_blah.zs:2 > unexpected end of file - ; expected [INITIALIZATION][CLIENT][ERROR] [crafttweaker | SIDE_CLIENT]: Error parsing blah_blah_blah.zs:2 -- ; expected ``` ### 导包错误 导入的包不存在。 示例： ```csharp // 少打了个 . import crafttweaker.itemIItemStack; ``` 报错： ```log [INITIALIZATION][CLIENT][ERROR] no_easter_egg_for_you.zs:1 > No such member: itemIItemStack [INITIALIZATION][CLIENT][ERROR] no_easter_egg_for_you.zs:1 > Not a valid type ``` ### 缺少导包 除了基本数据类型，其他所有出现 `as Type` 的语句，比如声明变量，函数的参数与返回值，强制转型等，都需要导入对应的类。 示例： ```csharp // 需要导入 IItemStack 包 val apple as IItemStack = ; function foo(item as IItemStack) { print(item.commandString); } ``` 报错： ```log [INITIALIZATION][CLIENT][ERROR] did_you_miss_me.zs:1 > could not find type IItemStack [INITIALIZATION][CLIENT][ERROR] did_you_miss_me.zs:3 > could not find type IItemStack [INITIALIZATION][CLIENT][ERROR] did_you_miss_me.zs:4 > any values not yet supported ``` ### 导入语句未写在脚本头部 所有 import 必须写在一起，且在脚本的头部。 示例： ```csharp val foo as string = "bar"; import crafttweaker.item.IItemStack; val apple as IItemStack = ; ``` 报错： ```log [INITIALIZATION][CLIENT][ERROR] [crafttweaker | SIDE_CLIENT]: Error parsing hello_mister_freeman.zs:3 -- Invalid expression, last token: import ``` ### 方法传入参数错误 示例： ```csharp // 输入为 recipes.addShaped(string, IOreDictEntry, IIngredient[][]); // 其中 IOreDictEntry 类型错误，输出类型只能为 IItemStack。 recipes.addShaped("recipe_name_here", , [ [, , ], [, null, ], [, , ] ]); ``` 报错： ```log // 有 2 个可用方法，但你的脚本并不匹配其中任何一个 [INITIALIZATION][CLIENT][ERROR] wake_up_and_smell_the_ashes.zs:1 > 2 methods available but none matches the parameters (string, ZenTypeNative: crafttweaker.oredict.IOreDictEntry, any[]) // 这一般是您脚本中有问题，而不是模组的问题 This is usually an error in your script, not in the mod // 可用方法对应参数一览 addShaped(string, ZenTypeNative: crafttweaker.item.IItemStack, ZenTypeNative: crafttweaker.item.IIngredient[][], Optional ZenTypeNative: crafttweaker.recipes.IRecipeFunction, Optional ZenTypeNative: crafttweaker.recipes.IRecipeAction) addShaped(ZenTypeNative: crafttweaker.item.IItemStack, ZenTypeNative: crafttweaker.item.IIngredient[][], Optional ZenTypeNative: crafttweaker.recipes.IRecipeFunction, Optional ZenTypeNative: crafttweaker.recipes.IRecipeAction) ``` ### 没有对应方法 示例： ```csharp .retard(); ``` 报错： ```log // 在 IItemStack 类中（因为 是 IItemStack）找不到名为 retard 的方法 [INITIALIZATION][CLIENT][ERROR] whos_next_im_tired.zs:1 > No such member in crafttweaker.item.IItemStack: retard ``` IItemStack 类没有名字为 `method` 的方法。 ### 尖括号引用错误 一般是拼错单词导致的，为啥不用 `/ct hand` 呢？ 示例： ```csharp // 我很确定原版没有菠萝 print(.commandString); ``` 报错： ```log // 无法解析 [INITIALIZATION][CLIENT][ERROR] what_the_hell_is_a_pineapple.zs:1: Could not resolve ``` ### 找不到变量 报错 `can not find xxx` 造成这个问题的错误可能有： * 变量名拼写错误 * 在变量声明前使用变量 * 引用 loader 不一样的脚本内的变量 * 使用作用域之外的变量 作用域代表了变量的可用范围。你不能使用作用域之外的变量，也不能在同一个作用域声明两个重名的变量。ZenScript 分为全局作用域、脚本作用域、参数作用域和局部作用域。 ```csharp import crafttweaker.item.IItemStack; // 全局和静态变量的作用域为全局作用域，可以用于全体脚本 // 不过不包括 loader 不一样的脚本 global a as int = 450; static b as int = 100; // 这个变量不属于任何函数，也不在 if for 等代码块内，属于脚本作用域，可以用在这个脚本内的任何地方，但不能用于其他脚本 val item as IItemStack = ; for i in 0 .. 10 { // 这里的 i 属于参数作用域，i 为这个 for 循环的参数，只可在下面大括号内的循环体使用 // 每层大括号都是一个局部作用域 val j as int = i * 5; val i as int = 233; // 错误，参数作用域内已经定义了 i 变量 val item as IItemStack = ; // 错误，脚本作用域内已经定义了 item 变量 if (i < 4) { val k as int = i + 1; // 又开一个局部作用域 print(k); } print(k + 1); // 错误，该作用域内未声明 k 变量 } print(i); // 错误，i 变量声明在上面的 for 循环的参数作用域内，在这个循环之外 i 变量是不存在的 recipes.addShapeless("nether_recipe",, [,,], function(output, ins, info) { // 函数参数作用域，该函数体内可以使用这个作用域内的三个变量 return info.player.world.dimension == -1 ? output : null; }, null); print(output.commandString); // 错误，output 变量只存在于上面的函数参数作用域内，在这个函数之外 output 变量不存在 // 上面的 output 变量只存在于上面的函数内，所以你可以在函数外声明 output 变量，但你要知道这两个变量只是同名但不是同一个 val output as IItemStack = ; ``` 你也可以意识到代码缩进的必要性了，可以很清晰的分清包括变量作用域的代码层次结构。 ### 字符串落双引号 缺少双引号的 string 会被识别为变量关键字，但在声明 map 的 key 中例外，变量会被当成字符串处理。 示例： ```csharp // 缺少双引号，按变量关键字处理 print(itshouldbeastringbutitsnot); ``` 报错： ```log [INITIALIZATION][CLIENT][ERROR] hey_my_name_is_gary.zs:1 > could not find itshouldbeastringbutitsnot ``` ### 对 val 变量重新赋值 报错 `value cannot be changed` 如果需要重新赋值，请使用 `var` 来声明变量。 ### 对函数参数重新赋值 报错 `not a valid lvalue` ```csharp function foo(bar as int) { print(bar); bar += 1; // 错误，函数参数不可重复赋值 print(bar); } ``` 如果你真的有这个需求，可以考虑新建一个变量，初值设为参数 ```csharp function foo(bar as int) { var baz as int = bar; print(baz); baz += 1; print(baz); } ``` ### 匿名函数内对外部变量进行赋值 匿名函数只能重新赋值函数内部的局部变量，不能重新赋值外部变量。事件什么的都是匿名函数的说。不过更新数组、Map 的元素是可以的。 ```csharp var foo as int = 250; recipes.addShapeless("nether_recipe",, [,,], function(output, ins, info) { // 匿名函数 print(foo); // 可以访问外部变量 foo = 450; // 错误，不能改变外部变量的值 return info.player.world.dimension == -1 ? output : null; }, null); ``` 报错 `not a valid lvalue` ### CoT 脚本内声明物品需 item: 开头 这个 `/ct syntax` 查不出的（ ## 运行时错误 除了以上编译时错误之外，有些错误只会在脚本运行时才出现，一般是脚本遇到处理不了的情况，这种错误一般无法用 `/ct syntax` 发现。魔改时请务必注意。大部分运行时错误由 java 异常形式体现，你可以通过异常的 stack trace 查看哪里出问题了。 ```log [INITIALIZATION][CLIENT][ERROR] 发生什么事了 异常名: 异常描述 at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65) // 内部 java 代码 at java.lang.Integer.parseInt(Integer.java:580) at java.lang.Integer.parseInt(Integer.java:615) at I_just_wanna_dance.__script__(i_just_wanna_dance.zs:1) // 报错时所运行的脚本及函数，认准 zs 即可 at __ZenMain__.run(I_just_wanna_dance) // 所有脚本的入口 ...... ``` ### 使用加号连接字符串与数字 示例： ```csharp print(3 + "and"); ``` 报错： ```log [INITIALIZATION][CLIENT][ERROR] [crafttweaker]: Error executing {[0:crafttweaker]: i_just_wanna_dance.zs}: For input string: "and" java.lang.NumberFormatException: For input string: "and" at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65) at java.lang.Integer.parseInt(Integer.java:580) at java.lang.Integer.parseInt(Integer.java:615) at I_just_wanna_dance.__script__(i_just_wanna_dance.zs:1) at __ZenMain__.run(I_just_wanna_dance) ...... ``` 请使用飘号 (`~`) 连接字符串。 ### 数组越界 数组越界错误有若干成因，在此使用最常见的索引超出数组长度问题举例。 示例： ```csharp import crafttweaker.item.IItemStack; // 数组长度为 2，最大索引为1 val toRemove as IItemStack[] = [ , ]; // 鉴于 ZenScript 支持遍历非整数类型数组 // 更好的写法其实是 for remove in toRemove {} for i in 0 .. 3 { // 0 .. 3 实际返回为 [0, 1, 2] recipes.remove(toRemove[i]); } ``` 报错： ```log [INITIALIZATION][CLIENT][ERROR] [crafttweaker]: Error executing {[0:crafttweaker]: ladies_and_gentlemen_we_got_him.zs}: 2 java.lang.ArrayIndexOutOfBoundsException: 2 at Ladies_and_gentlemen_we_got_him.__script__(ladies_and_gentlemen_we_got_him.zs:15) at __ZenMain__.run(Ladies_and_gentlemen_we_got_him) at crafttweaker.runtime.CrTTweaker.loadScript(CrTTweaker.java:240) at crafttweaker.runtime.CrTTweaker.loadScript(CrTTweaker.java:105) at crafttweaker.mc1120.events.CommonEventHandler.registerRecipes(CommonEventHandler.java:71) ...... ``` ### 空指针 一些 Getter 可能会返回 null，而试图对 null 使用任何方法、Getter 会抛出空指针异常（`NullPointerException`，简称 NPE）。你需要事先用 isNull 函数判断其是否为 null，不是则跳过操作。比如，你需要获取副手的物品的 id，如果和指定的相同，则进行接下的操作 ```csharp var offItem as IItemStack = player.offHandHeldItem; if (offItem.definition.id == "minecraft:sand") { ... } ``` 但是这样，若玩家副手没有物品，offItem 就是 null，对 null 使用方法会抛出异常。你需要用 isNull 函数 ```csharp var offItem as IItemStack = player.offHandHeldItem; if (!isNull(offItem) && offItem.definition.id == "minecraft:sand") { ... } ``` `&&` 是短路逻辑和，若前面的运算结果为 false，结果将直接为 false，后面的运算不再运算。（前文的 `||` 同理） 在这个例子中，先判断 isNull 函数，如果 offItem 为null，isNull 函数结果为 true，取反后为 false，（运算优先级：非大于和大于或）结果直接判断为 false，后面的`offItem.definition.id == "minecraft:sand"` 运算跳过。只有 offItem 不为 null，才会检测其 ID，从而规避空指针异常。