---
title: MD变量和表达式
summary: 字符串,列表,表格,存在检查和明确的变量名称空间.
section: scripting
kind: guide
status: example
updated: 2026-10-27
tags: ["X4","modding","md","variables"]
sources: ["https://wiki.egosoft.com/X%20Rebirth%20Wiki/Modding%20support/Mission%20Director%20Guide/"]
---
## 价值观和表达


许多MD属性包含表达式. XML 引用界限属性,而内部单个引用则构成 MD 字符串字母. 列表和表格具有不同的访问模式: `$Items.{1}` 读取列表位置; `$ByID.{$Key}` 读到一个命名的桌面键.




```xml
<set_value name="$Label" exact="'Hello, X4'" />
<set_value name="$Count" exact="3" />
<set_value name="$Ready" exact="false" />
<set_value name="$Items" exact="[]" />
<set_value name="$ByID" exact="table[]" />
```

## 验证请求形状


实例检查其处理器内部的接入UI有效载荷. 列表长度不证明元素类型. 在应用设置之前验证文本并切换值.




```xml
<do_if value="typeof $Payload == datatype.list and $Payload.count == 2">
  <set_value name="$Label" exact="$Payload.{1}" />
  <set_value name="$Enabled" exact="$Payload.{2}" />
</do_if>
```

## 存在和范围


`not $Records?` 检查变量存在. 需要的物体 `.exists`. 其他标志性参考,如 `Init.$Records` 具体选择文本. 假,空清单和缺失变量是不同的状态;不要取代存在的内容检查.



## 明确选择变量所有权


不要假设 `$Value` 和 `this.$Value` 总是指同一个存储: `$Value` 通过名称空间解决. 选择一个合适的 `namespace="this"` 例如,本地处理器数据; 存储在明确选择的环境中共享状态.



比较连续的两个请求:预期的字段是否改变,而第一个请求是否泄露到第二个字段? 看到 [MD 库](wiki:md-libraries) 对于一个参数化可重复使用的标志.