LearnMindustryMod

Appearance

JavaScript 基础语法 ​

这一节我们将介绍 JavaScript 的基础语法,包括变量声明、数据类型、运算符、控制结构等内容。尽管我们的核心目的是写出能在Mindustry中运行的JavaScript代码,但理解这些基础语法对于编写高效、可维护的代码是非常重要的。

通用语法 ​

这一部分将介绍一些JavaScript的通用语法规则,这些规则在任何JavaScript环境中都是适用的。这节的内容都可以在w3school的js教程中找到,这里也总结了其中一些重要的语法规则。

变量类型 ​

JavaScript中有几种基本的数据类型:

  • Number数字: 用于表示浮点数。例如: let x = 10.0; JavaScript中的数字类型没有整数和浮点数之分,然而编写mdt的java有,所有不要在应该填整数的地方填浮点数,以及抄源码的时候记得把数字末尾的f去掉。
  • String字符串: 用于表示文本数据,由一系列字符组成。例如: let name = "Mindustry";
  • Boolean: 用于表示逻辑值,只有两个取值: true 和 false。例如: let isActive = true;
  • Object对象: 用于表示复杂数据结构,由键值对组成。例如:
javascript

let person = {
  name: "Alice",
  age: 30
};

let block = new Block("block"); // mdt的方块,也是对象
  • Array数组: 用于表示有序的列表,可以包含任何类型的元素。例如:
javascript
let numbers = [1, 2, 3, 4, 5];
let mixed = [1, "two", true, { name: "Alice" }];

注意数组索引从0开始,所以numbers[0]是1,而不是2。

变量声明 ​

在JavaScript中,我们可以使用var, let, 或 const来声明变量。简单来说:

  • var 是最早的变量声明方式,它有一些作用域上的问题,不推荐使用。注意和mdt中常用的Vars区分开来
  • let 块级作用域变量声明方式,推荐使用。一般用于for循环
  • const 用于声明常量,即值不能被重新赋值的变量。不要用它声明数字(Number)和字符串(String),而是用于声明对象(Object)和数组(Array)等复杂数据类型。

我们一般这样声明变量:

javascript
let x = 10; // 数字类型
let isActive = true; // 布尔类型
let name = "Mindustry"; // 字符串类型 用得少
const block = new Block("block"); // mdt的方块 对象类型

// 理论上也可以不初始化变量,但不推荐
let y; // 声明一个变量但不赋值

//此处省略其他示例代码

y = 20; // 再给y赋值

如你所见,我们在声明变量时并没有指定变量的类型,这是因为JavaScript是一种动态类型语言,变量的类型是根据赋值来确定的。你可以随时给一个变量赋不同类型的值,但这可能会导致代码难以维护和调试,因此建议在编写代码时保持变量类型的一致性。

javascript

let a; // a的类型是undefined
a = 10; // a现在是一个数字
a = "Hello"; // a现在是一个字符串
a = true; // a现在是一个布尔值

在编写代码时尽量保持变量类型的一致性,这样可以提高代码的可读性和可维护性。如果一个变量的类型已经确定但初始值不明确,建议在声明时给它一个合理的初始值,以明确变量的用途。

javascript

let a = 0; // 数字
let b = ""; // 字符串
let c = false; // 布尔值
let d = {}; // object类型
let e = []; // 数组类型

变量的命名规则 ​

  • 变量名必须以字母、下划线 _ 或美元符号 $ 开头,后面可以跟字母、数字、下划线或美元符号。

  • 变量名区分大小写,例如 myVariable 和 myvariable 是两个不同的变量。

  • 变量名不能是JavaScript的保留字,如 let, const, if, else, for, while 等。

  • 变量名最好和你写的mdt内容的name相同,比如:

javascript

const triploid = new UnitType("triploid"); 
const biomassSteel = new Item("biomass-steel",Color.valueOf("4e342e"));
// 变量名和mdt内容的name相同,这样可以提高代码的可读性和可维护性

对于具体的内容我们习惯上使用小写字母开头的驼峰命名法,比如 protein,biomassSteel 等, 而对于你自己构造的函数我们习惯上使用大写字母开头的驼峰命名法,比如 Block, UnitType, DrawPart 等。

理论上来说,中文是可以作为变量名的,不过如果你用中文变量名,你可能需要频繁切换输入法.

运算符 ​

  • 算术运算符: +, -, *, /, % 等。例如:
javascript

let sum = 10 + 5; // 15
let difference = 10 - 5; // 5
let product = 10 * 5; // 乘法 50
let quotient = 10 / 5; // 除法 2
let remainder = 10 % 3; // 取余 结果是1

let square = 5 ** 2; // 乘方 结果是25
let square = Math.power(5,2); // 乘方的另一种写法 结果是25

let a = 10 * 2 + 5; // 25,乘法优先级高于加法
let b = (10 + 5) * 2; // 30,括号改变了运算顺序

let x = 10;
x++; // 递增 x现在是11 for循环里好用

x--; // 递减 x现在是10
  • 比较运算符: ==, ===, !=, !==, <, >, <=, >= 等。例如:
javascript
let isEqual = (10 == "10"); // true, == 不是严格比较,会进行类型转换
let error1 = (10 = "10"); 
/* 
一个常见的语法错误,单等号是赋值运算符,而不是比较运算符
如果你这样写了,你会得到一个SyntaxError: Invalid left-hand side in assignment错误
这个错误有时会让人很头大,因为=在自然语言中是一个比较运算符,但实际上是一个赋值运算符
而且mdt不会报这个错误的行号
*/
let warning = (true == 'false'); // true, == 进行类型转换后, true和'false'都被转换成了true

let isStrictEqual = (10 === "10"); // false, === 是严格比较,不进行类型转换
let isNotEqual = (10 != "10"); // false, != 不是严格比较,会进行类型转换
let isStrictNotEqual = (10 !== "10"); // true, !== 是严格比较
let isGreater = (10 > 5); // true
let isLess = (10 < 5); // false
let isGreaterOrEqual = (10 >= 10); // true 注意不要写成10 => 10,记住大于等于,先写大于号,再写等于号,不要反过来
let isLessOrEqual = (10 <= 5); // false
  • 逻辑运算符: && (逻辑与), || (逻辑或), ! (逻辑非) 等。例如:
javascript
let isTrue = true && true; // true
let isFalse = true && false; // false
let isEitherTrue = true || false; // true
let isNeitherTrue = false || false; // false
let isNotTrue = !true; // false
let isNotFalse = !false; // true
  • 赋值运算符: =, +=, -=, *=, /=, %= 等。例如:
javascript
let x = 10; // 赋值
x += 5; // x现在是15,相当于 x = x +
x -= 3; // x现在是12,相当于 x = x - 3
x *= 2; // x现在是24,相当于 x = x * 2
x /= 4; // x现在是6,相当于 x = x / 4
x %= 4; // x现在是2,相当于 x = x % 4
  • 其他运算符: 还有一些其他的运算符,如三元运算符 ? :, 位运算符 &, |, ^, ~, <<, >>, >>> 等,以及一些特殊的运算符如 typeof, instanceof, in 等。这些运算符在某些特定的情况下非常有用,但在编写mdt脚本时可能用得不多,所以我们暂时不深入介绍它们。

if 和 for 语句 ​

  • 条件语句: if, else if, else 等。例如:
javascript
let x = 10;

if (x > 10) {
  console.log("x is greater than 10");
} else if (x === 10) {
  console.log("x is equal to 10");
} else {
  console.log("x is less than 10");
}
  • 循环语句: 有for, while, do...while 等。

对于大多数mdt脚本, for 循环通常足够使用,其他循环语句在mdt脚本中较少用到.

javascript
// for循环的语法是: for (初始化; 条件; 更新) { 代码块 }
// 这是某个mdt脚本单位draw()里的一段代码,它使用了for循环来绘制一个旋转的圆弧
for (let i = 0; i < 3; i++) {
    let rot = i * 360 / 3 + Time.time * 1;
    Lines.arc(unit.x, unit.y, range, 0.15, rot);
}

// 不用for循环的话,你就得写三段几乎一模一样的代码,这样不仅冗长,而且不易维护

Lines.arc(unit.x, unit.y, range, 0.15, 0 + Time.time * 1);
Lines.arc(unit.x, unit.y, range, 0.15, 120 + Time.time * 1);
Lines.arc(unit.x, unit.y, range, 0.15, 240 + Time.time * 1);

//for循环也可用于批量创建对象,比如在mdt脚本里创建多个部件
for (let i = 0; i < 3; i++) {
    triploid.parts.add(
    Object.assign(new RegionPart("-blade"), {
        layerOffset: -0.001,
        x: 2,
        moveX: 6 + i * 1.9,
        moveY: 8 + -4 * i,
        moveRot: 40 - i * 25,
        mirror: true,
        progress: DrawPart.PartProgress.warmup.delay(i * 0.2)
    }))
}
//这段代码创建了三个部件,它们的moveX、moveY、moveRot属性根据i的值不同而不同,如果不用for循环的话,你就得写三段几乎一模一样的代码,这样不仅冗长,而且不易维护

//如果你需要遍历一个数组或者对象的属性,你也可以使用for循环,比如:
let numbers = [1, 2, 3, 4, 5];
for (let i = 0; i < numbers.length; i++) {
    console.log(numbers[i]);
}

//for...of循环或者for...in遍历数组时通常更简洁,例如:
let numbers = [1, 2, 3, 4, 5];
for (let number of numbers) {
    console.log(number);
}

for (let index in numbers) {
    console.log(numbers[index]);
}

// 注意for...of循环直接获取数组的元素,而for...in循环获取数组的索引

以上就是JavaScript的一些基础语法规则,如果你觉得你懂了,那么试着完成下面的小测:

javascript

// 1. 声明一个变量,并给它赋值为一个字符串类型

// 2. 预测下面代码的输出结果
//(1)
console.log(10 == '10');
//(2) 
console.log(10 === '10');
//(3)
console.log(true == 'false');
//(4)
console.log(10 > 5 && 5 > 3);
//(5)
console.log(10 > 5 || 5 < 3);
//(6)
console.log(10 % 3);

//(7)
let x = 1;
for (let i = 1; i < 6; i++) {
    x *= i;
}
console.log(x);

//(8)
let numbers = [1, 2, 3, 4, 5];
for (let i = 1; i < 5; i++) {
    console.log(numbers[i]);
}

// 3.指出下面节选代码中的错误并修正它

// 错误代码1 

// 假设a已经被声明并赋值了
if (a => 5) {
    console.log("a is greater than 5");
} else if (a = 5) {
    console.log("a is equal to 5");
} else {
    console.log("a is less than 5");
}

// 错误代码2
let switch = false;
if (switch) {
    console.log("The switch is on");
} else {
    console.log("The switch is off");
}

参考答案:

javascript

// 1. 声明一个变量,并给它赋值为一个字符串类型
let name = "Mindustry";
// 2. 预测下面代码的输出结果
//(1) true, == 不是严格比较,会进行类型转换
//(2) false, === 是严格比较,不进行类型转换
//(3) true, == 进行类型转换后, true和'false'都被转换成了true
//(4) true, 10 > 5 是true, 5 > 3 是true, 所以 true && true 是true
//(5) true, 10 > 5 是true, 5 < 3 是false, 所以 true || false 是true
//(6) 1, 10 % 3 的结果是1
//(7) 120, 1 * 1 = 1, 1 * 2 = 2, 2 * 3 = 6, 6 * 4 = 24, 24 * 5 = 120
//(8) 2, 3, 4, 5, 因为数组索引从0开始,所以 numbers[1] 是2, numbers[2] 是3, numbers[3] 是4, numbers[4] 是5

// 3.指出下面节选代码中的错误并修正它
// 错误代码1

if (a >= 5) { // 错误1: => 是一个语法错误,应该是 >=
    console.log("a is biger than 5");
} else if (a == 5) { // 错误2: = 是赋值运算符,应该是 ==
    console.log("a is equal to 5");
} else {
    console.log("a is less than 5");
}
// 而且设计也有问题,无论a为何值,修改后的代码都会输出"a is biger than 5"或者"a is less than 5",因为条件a >= 5包含a == 5的情况


// 错误代码2
let switch = false;// switch是JavaScript的保留字,不能用作变量名

// 修改后的代码
let isSwitchOn = false; // 修改变量名为isSwitchOn,避免使用保留字