用户自定义函数是由程序员编写的函数，不同于 Pine Script内置提供的函数。它们用于封装脚本中需要有条件执行或重复执行的自定义计算，或者将逻辑集中在一个位置，以提升模块化程度和代码可读性。当现有的内置函数无法满足需求时，程序员通常会编写自定义函数来扩展脚本的功能。

一个函数定义由两个主要部分组成：函数头（Header） 和 函数体（Body）。

‍

函数头（Header）

函数头声明了函数的签名，也就是函数的名称和参数。脚本通过创建一个包含函数名并跟随括号的表达式来调用该函数（例如 f()）。

‍

函数体（Body）

函数体是紧随函数头之后的代码。每一次函数调用，都会执行函数体中由表达式和语句定义的任务。

‍

用户自定义函数的通用特性和限制

无论函数的格式、位置或用途如何，所有用户自定义函数都遵循以下共同特性和限制：

• 函数的定义必须位于全局作用域。程序员不能在另一个函数的函数体内，或其他任何结构的局部代码块中定义函数。
• 函数不能修改其已声明的参数，也不能修改任何全局变量。
• 函数体内可以调用大多数其他函数，但不能调用自身，也不能调用必须从全局作用域调用的函数。
• 函数的每一次书写调用，在所有执行过程中都必须具有一致的参数类型，因此传入的参数类型也必须一致。
• 每一次调用都会返回函数体中最后一个语句或独立表达式的计算结果，并且该结果会继承调用中使用的最强类型限定符。与参数类型一样，返回值类型在不同执行中也必须保持一致。
• 每一次对函数的书写调用都会基于函数定义创建一个新的作用域。在该作用域中创建的参数、变量和表达式都是独立的，并且拥有各自的历史记录；不同的函数调用不会直接相互影响。

‍

函数头语法

[export ]<functionName>([[[paramQualifier ]<paramType> ]<paramName>[ = defaultValue], …]) =>

‍

其中：

• 方括号 [] 中的内容表示可选语法，尖括号 <> 中的内容表示必需语法。
• export 是一个可选关键字，用于将函数从库中导出，使其可以在其他脚本中使用。详情请参阅 Libraries 页面。
• functionName 是函数的标识符（名称）。脚本通过引用该标识符并跟随括号来调用函数。
• paramName 是已声明参数的标识符。脚本在每次函数调用时，可以为该参数提供具体的参数值（值或引用）。函数头中可以声明零个或多个参数。
• defaultValue 是参数的默认值。如果未指定默认值，则每次调用函数时都必须为该参数提供参数；如果指定了默认值，则传参是可选的。
• paramQualifier 和 paramType 是限定符和类型关键字，它们共同指定参数的限定类型。在大多数情况下，这些关键字是可选的。如果未包含它们，编译器会自动推断参数的类型信息。更多内容请参阅 Declaring parameter types 部分。

‍

单行函数 – 示例1

单行函数的函数体与函数头位于同一行代码中。该格式非常适合用于定义紧凑的函数，这类函数只执行简单的语句，并且不使用条件结构或循环。定义单行函数的语法如下：

‍

<functionHeader> => {statement, }<returnExpression>

‍

其中，functionHeader 用于声明函数的名称和参数，其含义与上一节中的说明一致。花括号中的 statement 表示函数在返回结果之前要执行的零个或多个语句或表达式，函数体中的每一条独立语句都必须使用逗号分隔。returnExpression 是函数体中的最后一个表达式、变量或元组，每一次函数调用都会返回对该部分代码求值后的结果。

下面的示例以单行格式定义了一个 add() 函数。该函数包含两个参数 val1 和 val2。函数体中只有一个 + 运算，根据参数的类型不同，该运算可以执行数值相加或字符串拼接。每次调用该函数，都会返回该运算的结果：

add(val1, val2) => val1 + val2

在脚本中包含了该函数定义之后，就可以在不同的位置调用 add()，并为 val1 和 val2 传入不同的参数。每一次调用所返回的值类型，取决于传入参数的类型。例如，在下面的脚本中，会执行多次 add() 调用，然后将其返回结果传递给 plot() 函数的 series、title 和 linewidth 参数。

‍

‍

下面逐行解析代码：

• 指定脚本版本。
• 声明这是一个指标脚本，并设置指标名称。
• 定义一个单行函数 add()。
• 调用 add() 函数，并把返回结果存入变量 a。
• 把变量 a 画成一条线。
• 最终效果：在图表上画出一条线，其数值等于每根 K 线的 open + close。

‍

‍

单行函数 – 示例2

‍

例如，下面的脚本以单行格式定义了一个 zScore() 函数。该函数用于计算某个源数据序列在 length 根 K 线上的 Z-Score（标准分数）。函数体中声明了两个变量 mean 和 sd，分别用于保存该序列的平均值和标准差。函数体中的最后一个表达式使用这两个变量来计算并返回函数的结果。脚本在每一根 K 线上都会调用一次 zScore() 函数，使用 close 作为源数据参数、20 作为长度参数，然后将计算结果绘制出来。

‍

‍

核心部分是 zScore 函数的定义。函数使用多行单行函数写法，通过箭头符号 => 声明。函数接收两个参数：source 表示数据序列，如收盘价 close，length 表示计算周期，如 20 根 K 线。函数内部首先计算 mean = ta.sma(source, length)，即 source 的简单移动平均，用于反映周期内的均值；然后计算 sd = ta.stdev(source, length)，即标准差，用于衡量数据的波动性。最后，函数返回 (source - mean) / sd，即标准分数（Z-score），表示当前值与均值的偏离程度以标准差为单位。

在函数定义之后，脚本调用 zScore 函数：float osc = zScore(close, 20)。这里使用收盘价作为源数据，计算 20 根 K 线周期的 Z-score，并将结果存入变量 osc。由于 Z-score 随每根 K 线变化，因此 osc 实际上是一个随时间变化的序列（series float），每根 K 线都有对应的值。

最后，脚本通过 plot 函数将 osc 绘制在独立面板上。plot(osc, "Z-score", osc > 0 ? color.green : color.red, style = plot.style_columns) 指定了绘制的数据为 osc，图例名为 “Z-score”，并根据值的正负设置颜色：正值为绿色，负值为红色，同时使用柱状图风格 plot.style_columns 展示每根柱子的高度。这样，独立面板上便能直观显示价格相对于均值的标准差偏离，绿色柱表示高于均值，红色柱表示低于均值。

‍

‍

本文系统介绍了 TradingView Pine Script 中用户自定义函数的概念、定义方法及使用技巧。文章首先讲解了函数的组成，包括函数头部的名称与参数声明以及函数体中表达式和语句的执行逻辑，并区分了单行函数与多行函数的写法与适用场景。随后通过具体示例，如 add() 和 zScore()，展示了函数的实际应用，包括如何封装重复计算、处理序列数据、返回计算结果以及在脚本中调用函数。

总体而言，通过对函数定义、调用、序列计算及绘图技巧的详细解析，读者不仅能够掌握 Pine Script 中自定义函数的使用方法，还能够灵活构建可复用、模块化的指标脚本，为日后的策略开发和指标优化提供坚实基础。

‍

波动率头条可能会鼓励仓促做出决定，对于差价合约等杠杆产品来说，没有计划就采取行动可能会增加损失风险。在这样的时期，确实出现了一种模式。

‍新闻冲击 → 情绪反应 → 冲动交易 → 可避免损失的风险更高

这与其说是 “错误”，不如说是跳过标题和交易想法之间的情感反应。

翻译：标题不是你的信号。你的流程是。

中东突发事件、制裁、航运中断、地区安全冲击？这是你评估地缘政治事态发展可能如何影响市场的一般清单。

^{注意：本文仅提供一般信息，不是财务建议。它不考虑您的目标、财务状况或需求。差价合约是复杂的杠杆产品，具有很高的损失风险。考虑交易差价合约是否适合您，并在交易前参考相关的披露文件。}

第 1 步。识别司机

陷阱在这里：“伊朗” 不是驱动力。“冲突” 不是驱动因素。这些类别对有线电视新闻有用，但对于风险定义的差价合约交易来说过于宽泛。推动市场发展的是今天比昨天更糟糕的机制。将标题与特定机制分开。

‍驱动因素 A：能源风险

这是霍尔木兹海峡、航道、保险和改道的故事。在伊朗的突发事件中，市场之所以关心，是因为威胁不仅仅是 “战争”，而是石油物流的摩擦，包括油轮避开路线、保险费飙升和暂时暂停运输。当霍尔木兹风险被定价时，如果市场认为航运或供应风险增加，油价可能会迅速做出反应，这可能会影响通货膨胀预期。

驱动因素 B：供应风险

这不是 “船只紧张”。这与停产、基础设施中断、炼油厂中断和出口限制有关。当标题暗示物理伤害或可信的近期容量损失时，这种驱动因素往往更为重要。

驱动因素 C：资金压力

这是差价合约丑陋结果的未被充分讨论的引擎：“现在谁需要美元？”问题。这不是 “避险情绪”，而是流动性紧缩，这种情绪使市场共同走动，并可能伴随着更大的利差、滑点和更快的价格变动，这可能会影响执行。

在伊朗的危机中，当参与者停止辩论头条新闻并开始进行去风险的机械工作时，资金压力就会显现出来：广泛的美元需求、套利交易平仓以及风险资产的相关抛售。以下是防止你反应过度的关键过滤器：美元往往会持续走强，而且主要是在严重的资金压力下，而不是每一次例行的恐惧都会激增。

‍驱动因素 D：政策放大‍

这与其说是紧张局势的加剧，不如说是规则的变化，这种变化会超过头条周期，并迫使真正的重新定价，因为它会改变激励措施、准入或流动。如果通过制裁（供应、支付、运输、保险）、修改报复规则或在石油风险加剧通货膨胀风险的情况下转移中央银行反应职能来升级政策，那么伊朗冲突的头条新闻就不会停留在当地了。这可能会强化利率预期。

这就是 “地缘政治” 不再是叙事性而成为政策约束的地方，政策约束往往会带来后续行动，因为它们改变了市场参与者可以做的事情，而不仅仅是他们的想法。

在登上标题之前

如果你选择监控突发新闻，可以考虑在交易前暂停一下，检查是否有新的进展，现实世界中是否存在可观察到的限制，以及市场的反应。不要问 “这是看涨黄金吗？”。相反，请考虑：

1. 这是流量故事、桶装故事、融资故事还是政策故事？
2. 是新信息还是对市场已知信息的混合？
3. 是否有证据表明现实世界存在限制（航运行为、保险、官方措施），或者只是夸夸其谈？”

‍

第 2 步。确定关键市场

一些交易者只关注他们熟悉的一小部分市场，尤其是在头条新闻出现的时候。流动性和点差可以快速变化。如果你尝试观察所有内容，你最终可能会交易自己的肾上腺素而不是市场。

1) 石油（WTI 或布伦特原油代理）

‍如果驱动因素是能量流风险或供应风险，那么石油通常是第一个、也是最干净的重新定价渠道——风险溢价、通货膨胀冲动和全球增长预期都贯穿于此。

2) 美元条件（DXY 代理或您最可交易的美元对）

‍不是因为美元一直是 “避风港”，而是因为它是一切之下的融资层。在真正的压力下，你会看到美元的广泛走强；在 “头条压力” 中，你通常看不到。

3) 金牌

‍默认情况下，黄金并不 “因恐惧而上升”，其恐惧会渗透到美元和实际收益率中。如果美元融资压力加大，黄金可能会被拉向不同的方向，这就是交易者受到冲击的原因：他们交易的是故事，而不是交叉潮流。

4) 波动率指标（执行风险，不是意识形态）

‍这可以帮助衡量条件是否会导致更大的点差、滑点或更快的走势。

5) 您实际交易的工具

‍对于许多差价合约交易者来说，这就是伊朗冲击以当地市场、当地头寸和美元货币对的形式成为您的问题的地方。

不要按习惯绘图，按司机地图

• 能量流风险？ 首先是石油，然后是风险指数，然后是与风险/大宗商品挂钩的外汇。
• 资金压力？ 首先是美元走势，然后是日元交叉盘，然后是股票。
• 政策冲击？ 观察石油+美元加在一起——政策可以同时收紧两者。

翻译： 对于一些交易者来说，重点来自于关注与他们所评估的驱动因素最相关的较少的市场。

第 3 步。查看重要的图表

在考虑任何交易设置之前，一些交易者会进行快速的 “分类” 检查。目标不是预测，而是检查快速行情是否意味着差价合约等杠杆产品的点差扩大、滑点或大幅波动。

图 A：石油

你在检查什么： 市场定价是真正的颠覆风险，还是只是在做出反应？在与伊朗相关的突发事件中，“霍尔木兹风险” 的叙述往往表现为石油中的风险溢价对话，通常比股票或外汇中出现的要快。

一些交易者查看的图表功能示例包括

• 价格下跌并保持在先前的结构水平上方吗？（不只是飙升）。
• 是空白然后填补了吗？（通常意味着头条热度 > 实际约束）。
• 这种移动是在流动时段继续进行的，还是仅在稀疏时段内继续？（小盘走势是差价合约点差对您的惩罚最大的地方）。

翻译： 石油表明伊朗的故事可能会变成通货膨胀/流量故事还是仅仅是屏幕快照。

图表 B：美元

你在检查什么： 这变成了吗 资金 事件？美元没有按计划进行 “避风港”。在一些全球资金压力严重的时期中，美元普遍持续走强，尽管在所有头条推动的飙升中，这并不一致。

实用的 CFD 过滤器：

• 美元在多个货币对中走强（不仅仅是一个交叉盘做了奇怪的事情）。
• 大宗商品外汇兑美元（澳元，加元代理）表现得像风险，确实在紧缩。
• 日元作为压力指标交叉（套利平仓很快就能说明真相）。

如果美元没有确认，那就是信息。这通常意味着：标题风险很大，但全球流动性实际上并没有惊慌失措。

翻译： 美元表明伊朗的头条新闻是 “市场压力”... 还是 “利差更大、执行风险更高的市场噪音”。

图表 C：波动率

你在检查什么： 正常尺码已经变得多么危险。

使用可以强制诚实的尺码调节器：

• 正常范围 → 正常大小
• 约为 1.5 倍的典型范围扩展 → 考虑一半的尺寸
• 大约 2 倍范围扩展 → 四分之一大小或搁置一边

^{一些交易者缩小了头寸规模，或者在区间与通常条件相比大幅扩大时选择不进行交易。任何规模的方法都取决于个人情况和风险承受能力。}

因为在差价合约中，波动率不仅会改变方向性，还会改变执行质量、止损距离以及损失成为保证金问题的速度。

翻译： 波动性是您的许可单或停车标志。

‍

第 4 步。选择安装类型

地缘政治会造成波动，但不能保证趋势。

选择结构，而不是意见

• 突围： 在市场形成标题后的区间之后。
• 回调： 一旦趋势确立且流动性稳定。
• 均值回归： 前提是尖峰停滞且结构得到证实。

常见错误：先选择方向，然后确认狩猎。

翻译： 设置是对价格行为的回应，而不是你的世界观。

第 5 步。定义风险

从总体风险管理的角度来看，交易者通常认为交易理念只有在完成后才算完整

• 参赛条件： 你必须发生什么才能参与
• 失效： 你错在哪里
• 职位大小： 以美元风险为基础，而不是信念
• 会话最大损失： 每日或每周上限（保护您免受螺旋式交易的影响）

特别是对于差价合约，监管机构强调杠杆如何加速损失，以及为什么存在保证金平仓安排、杠杆限制和负余额保护（如果适用）等保护措施。

本周市场进入时将面临密集的美国数据以及月初的亚太地区增长支票。由于美国股市仍相对较高，黄金价格保持在5,000美元以上，短期价格走势可能对任何数据驱动的利率、美元走势和风险情绪的变化特别敏感。

‍

• 美国数据集群： 预计本周将公布ISM制造业、ISM服务业和ADP、非农就业人数（NFP）和零售销售数据。
• 亚太地区增长脉搏： 中国官方采购经理人指数和日本采购经理人指数、澳大利亚国内生产总值和中国财新采购经理人指数提供了区域活动数据。
• 股票： 尽管本周末出现了暂停，但美国主要指数总体上仍相对较高，这可能会增加对负面意外情绪的敏感度。
• 金牌： 已回落至5,000美元以上，使实际收益率和风险情绪成为焦点。
• 地缘政治： 中东地缘政治仍然是背景波动风险。

美国：增长和就业人数

美国周是由一系列紧张的活动、就业和消费者信号所塑造的，这些信号可能会迅速改变短期的利率预期。

市场通常从制造业情绪中获得第一线索，然后将目光投向服务业和私人就业人数，以获得更广泛的需求和招聘势头。

焦点是劳工报告，零售销售在同一窗口中增加了消费者交叉检查。

这种组合可能与美国国债收益率、美元定价和股票情绪有关，尤其是在指数仍处于相对较高水平的情况下。

关键日期

• 美国ISM制造业采购经理人指数: 3 月 3 日凌晨 2:00（澳大利亚东部夏令时间）
• 美国ISM服务业采购经理人指数: 3 月 5 日凌晨 2:00（澳大利亚东部夏令时间）
• 美国 ADP 就业人数: 3 月 5 日上午 12:15（澳大利亚东部夏令时间）
• 美国就业情况（NFP）: 3 月 7 日上午 12:30（澳大利亚东部夏令时间）
• 美国每月预付零售额（零售贸易）: 3 月 7 日上午 12:30（澳大利亚东部夏令时间）

监视器

• 美国国债收益率对ISM和工资意外情况的反应。
• 美元对利率重新定价的敏感度。
• 股票指数表现，尤其是大盘股的表现。
• 贸易政策的变化，关税的不确定性可能会产生影响。

‍

亚太地区：早期增长信号

亚太地区月初的日历可以快速了解区域活动是稳定还是疲软。

中国的采购经理人指数（官方和财新）为国有企业和私营部门企业提供了互补的视角，而日本的采购经理人指数可以通过增长预期直接影响日元的情绪。

澳大利亚的GDP增加了更广泛的宏观检查，可以影响当地的收益率定价和澳元的走向。总而言之，该集群为区域风险偏好定下了基调，并可能蔓延到大宗商品和基本金属。

关键日期

• 日本采购经理人指数： 3月2日上午11点30分（澳大利亚东部夏令时间）
• 澳大利亚国内生产总值： 3月4日上午11点30分（澳大利亚东部夏令时间）
• 中国官方采购经理人指数： 3 月 4 日下午 12:30（澳大利亚东部夏令时间）
• 中国财新采购经理人指数： 3 月 4 日下午 12:45（澳大利亚东部夏令时间）

监视器

• 澳元和当地对GDP的收益率敏感度。
• 日元对采购经理人指数数据的回应。
• 区域股市和大宗商品对中国活动趋势的反应。

‍

黄金和跨资产敏感度

由于黄金保持在5,000美元以上，它可能会对实际收益率、美元走势和更广泛的风险偏好的变化产生高度反应。

前端利率变动的宏观意外会迅速转化为黄金的波动，而影响石油和通胀预期的地缘政治事态发展也可能放大走势。

实际上，黄金可能充当本周市场如何消化增长、通货膨胀和政策不确定性的实时晴雨表。

监视器

• 美国实际收益率走势。
• 美元方向。
• 股票波动和避险流动。