如何在Unity项目中实现与C#/C/C++脚本的变量双向读写
Unity 与外部/C# 脚本双向读写变量实现方案
同工程内 C# 脚本与 Unity 交互(零依赖,最高效率)
这是 Unity 开发最常用的场景,由于 Unity 本身的运行时基于 .NET 框架,所有和 Unity 同程序集编译的 C# 脚本和场景内的 MonoBehaviour 处于同一个进程内存空间,不需要额外通信机制即可直接读写变量:
- 全局静态变量方案:直接在独立的 C# 脚本类中定义静态的 string、int 等类型变量,只要该类被 Unity 运行时加载,场景内所有脚本都可以直接通过类名访问、修改对应变量
Unity 侧访问示例:// 独立脚本文件,不需要挂在场景物体上 public static class ExternalVarStore { public static int ConfigInt = 10; public static string ConfigStr = "default_value"; }public class UnitySideTest : MonoBehaviour { void Start() { // 读脚本侧的变量 Debug.Log(ExternalVarStore.ConfigInt); // 修改脚本侧的变量 ExternalVarStore.ConfigStr = "value_from_unity"; } } - 场景单例方案:如果需要让变量和场景生命周期绑定,不需要用全局静态类,可以把变量挂在常驻场景物体的 MonoBehaviour 上单例化,其他脚本可以通过单例实例直接读写这些 public/SerializeField 标记的变量,和上述静态类的访问逻辑完全一致。
独立运行的外部脚本(脱离 Unity 进程)双向交互
如果你的 C#/C++ 脚本是独立运行的程序、不参与 Unity 的编译流程,需要和 Unity Editor 或者 PlayMode 下的 Unity 进程跨进程交换变量,可以根据场景选择以下方案:
- 低实时性要求场景:本地文件/共享配置交互
外部脚本把 int、string 类型的变量值序列化成纯文本/JSON,写入固定路径的本地配置文件;Unity 侧通过协程定时读取这个文件内容,解析后缓存成本地变量。反向流程同理:Unity 把自身要对外暴露的变量修改后写入同一个配置文件,外部脚本定时轮询读取即可拿到最新值。注意加文件锁避免读写冲突。 - 高实时性要求场景:本地 Socket/命名管道通信
外部脚本启动本地 TCP 服务端,绑定127.0.0.1的固定空闲端口,Unity 作为客户端主动建立连接,双方约定统一的数据帧格式(比如变量类型,变量名,变量值的纯文本格式),要修改变量时直接发送对应格式的数据包,对端收到后解析缓存即可。该方案不需要第三方依赖,C#、C++ 都有原生的网络 API 支持,端到端延迟可以控制在 1ms 以内。 - C/C++ 原生动态库交互
如果你的 C/C++ 代码是编译成 DLL(Windows)/so(Linux)/dylib(macOS)的动态链接库,不需要跨进程通信,Unity 可以直接把库加载到自身进程空间内:
在 C/C++ 侧导出统一的变量读写接口,比如:
Unity 侧通过extern "C" __declspec(dllexport) int GetIntValue(const char* key); extern "C" __declspec(dllexport) void SetIntValue(const char* key, int value); extern "C" __declspec(dllexport) const char* GetStringValue(const char* key); extern "C" __declspec(dllexport) void SetStringValue(const char* key, const char* value);[DllImport]特性直接调用这些导出函数,就能直接读写动态库内部存储的变量,全程没有额外通信开销。
注意事项
- 跨进程/跨语言传 string 时,统一使用 UTF-8 编码,避免中文内容乱码
- 使用动态库交互时,要对齐 C# 和 C++ 的基础类型内存大小,避免读取出的数值错乱
- 不要为同进程内的变量交互额外叠加网络/序列化层,徒增性能开销
内容的提问来源于stack exchange,提问作者IGamesI
相关产品推荐
相关产品推荐

