# 常见错误 在编写魔改脚本时，可能会出现一些常见的，有通用解的错误，在此列出名称、起因。 语法错误最好在 /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，从而规避空指针异常。 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://youyi580.gitbook.io/zentutorial/advanced/common-errors.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.