通达信期货指标公式如何编写自定义函数？

Question

在编写通达信期货指标公式时，如何正确创建和调用自定义函数是一个常见难题。许多用户发现，尽管已按语法定义了函数，但在主指标中调用时却提示“未知函数”或无法编译。问题通常出在：通达信的自定义函数必须以“FUNCTION:”开头，并保存在特定函数目录下，且仅支持在高级版公式系统中调用。此外，参数类型不匹配、函数命名冲突或未重新加载函数库也会导致调用失败。如何规范编写并成功引用自定义函数？这是提升指标复用性与开发效率的关键技术环节。

Answer 1

一、通达信自定义函数基础概念与创建规范

在通达信高级公式系统中，自定义函数是提升指标复用性与开发效率的核心机制。其本质是将一段可重复使用的逻辑封装为独立模块，供多个主指标调用。创建自定义函数的第一步是遵循严格的命名和语法规范。

• 函数文件必须以 FUNCTION: 开头作为标识符
• 函数名需符合命名规则：仅允许字母、数字和下划线，且不能以数字开头
• 每个函数应保存为独立的 .fun 文件
• 文件必须存放在通达信安装目录下的 function 子目录中（如：C:\new_tdx\function\）
• 函数定义格式如下：

FUNCTION: MyMovingAverage;
参数: N 整数 = 5;
说明: 简单移动平均线计算;
输出: MA 数值;
MA := SUM(CLOSE, N) / N;

上述代码定义了一个名为 MyMovingAverage 的函数，接受一个整型参数 N，返回周期内收盘价的算术平均值。注意冒号后无空格，这是通达信解析器识别的关键。

二、函数调用环境与版本兼容性分析

通达信的自定义函数功能并非在所有版本中可用。只有“高级公式系统”支持函数调用，普通版或精简客户端可能无法识别 FUNCTION: 标识。

通达信版本类型	是否支持自定义函数	典型应用场景
专业金融终端（高级版）	✅ 支持	量化策略开发、多因子模型
普通行情软件	❌ 不支持	基础技术分析
手机App端	❌ 不支持	移动端查看指标
Web在线版	⚠️ 部分支持	轻量级图表展示

开发者在部署前应确认所使用平台是否具备函数解析能力，否则即使语法正确也会报“未知函数”错误。

三、常见调用失败原因及诊断流程图

尽管函数已正确定义，但在主指标中调用时常出现“未知函数”提示。以下是典型问题链及其排查路径：

graph TD A[主指标编译失败] --> B{提示"未知函数"?} B -->|是| C[检查函数文件是否以FUNCTION:开头] B -->|否| D[检查语法错误] C --> E[确认文件位于function目录] E --> F[重启通达信或重新加载函数库] F --> G[验证函数名拼写一致性] G --> H[检查参数类型匹配] H --> I[查看是否存在命名冲突] I --> J[成功调用]

该流程图展示了从错误现象到最终解决的完整推理链条，适用于现场快速定位问题。

四、参数传递机制与类型匹配原则

通达信函数支持三种基本参数类型：数值、整数、常数。参数类型不匹配是导致运行时异常的重要因素。

• 数值型：用于浮点输入，如价格、成交量
• 整数型：用于周期、阶数等离散参数
• 常数型：编译期确定的固定值，优化性能

示例：若函数声明为 参数: N 整数 = 10;，但调用时传入 3.14，则会触发类型不匹配错误。

主指标中调用方式：

MA5: MyMovingAverage(5);
MA10: MyMovingAverage(10);

确保调用参数与定义一致，并避免使用变量作为整数参数（除非明确支持动态传参）。

五、函数库管理与热更新策略

通达信不会自动监听 function 目录变化。修改函数后必须手动触发重载机制。

1. 关闭当前公式编辑器
2. 重启通达信客户端
3. 进入“公式管理器” → “重新初始化”
4. 或使用快捷键 Ctrl + F7 强制刷新函数缓存

建议建立开发规范：每次更新函数后执行标准刷新流程，防止因缓存导致调试偏差。

此外，应避免多个函数使用相同名称，即使是不同目录下的文件也可能引发命名空间污染。