---
title: 日志与调试
summary: X4日志,有用的诊断标记以及进口,事件,执行和结果故障之间的区别.
section: start
kind: guide
status: reference
updated: 2026-10-27
tags: ["X4","modding","debugging"]
sources: ["https://wiki.egosoft.com/X%20Rebirth%20Wiki/Modding%20support/Mission%20Director%20Guide/","https://chemodun.github.io/x4/modding-support/running-x4-for-modding/"]
---
## 启用日志


通过下面的发射参数进行脚本诊断. 在游戏过程中实际使用的用户配置文件中找到日志,特别是多个测试配置文件. 添加一个特征 `debug_text` 标记在MD. Lua 游戏用户可以使用游戏的 `DebugError` 如果可用,则示例检查其事件API先决条件.




```text
-debug scripts -logfile debuglog.txt
```




```xml
<debug_text text="'WIKI: entered Read handler'" />
```




```lua
if type(RegisterEvent) ~= "function" then
    DebugError("[WIKI] UI event API unavailable")
    return
end
```

## 发生了四次失败


| 阶段 | 检查 |
| --- | --- |
| 进口 | XML 有效性,方案,文件名,依赖性 |
| 事件 | 屏幕/控制名称和回调登记时间 |
| 执行 | 参数类型,对象存在和权限 |
| 结果 | 游戏中的实际值,对象,账号或队列 |


发送事件后立即不要记录通用成功. 使用精确的标记,如 `sent`, `received`, `validated`, `applied` 和 `readback_ok`.



## 收集一个完整的快照


在报告差异之前,请阅读所有要求的事实. 停在第一次不匹配时会失去对其他物体的证据, 检查的UI环境缺乏标准Lua `debug` 根据本文库的规定, 短边界的输入/参数标记有助于调查地图回调.



## 没有常见陷的引据发射


化学敦的X4 9.00调查区分 `-logfile`, 开封一个文件, `-debug`, 只有他自己创造了没有. 作为单独的参数重复过器:



```text
-debug scripts -debug fileio -logfile logs/wiki-session.log
```



**预期：** `logs/wiki-session.log` 在活跃的个人资料中,使用脚本和文件诊断. `-debug scripts,fileio` 没有两个过器的等价. 在下一次发射之前复制有用的日志.



`debug_to_file` 需要 `-scriptlogfiles` 标志;该动作的属性提供其文件名称和目录,而不是标志后的单词. `-godlog` 报告是电站发电,而不是现今世界的普遍清单. 源子描述了它的尺寸和限制.



## 单独的实验资料


其他参数,而不是自动发射命令:



```text
-personalfolderid wiki_lab -dontsaveconfig -skipintro
```



首先选择一个独立的个人资料. `-dontsaveconfig` 块 `config.xml` 对于会议的编写;它不保护每一个保存或 `userdata.xml`. 其他没有保存模式. 保存一个单独的保存和故意调整列表. 传输参数给X4本身;第三方发射器快捷方式可能不会传输它们.



这些模式并不是本文运行的. 记录准确的论点和游戏版本. 对于NPC对象,读取 [工作和上帝](wiki:jobs-and-god).