Pine Script（15）：函数受限及相应解决方案

当你兴高采烈地学会了if语句，准备大展拳脚，很可能马上就会撞上PineScript里最著名的一堵墙，看到一个让你摸不着头脑的错误：“Cannot use '...' in local scope”（不能在局部作用域中使用…）。

这到底是什么意思？为什么有些函数不能放在if里面？别慌，这节课，学长就带你彻底搞懂这个问题，并给你一套万能的解决方案。

为什么会报错：“全局”与“局部”的区别

我们先来看一个会报错的简单例子，它尝试只在周一画出EMA均线：

//@version=6
indicator(title="条件函数错误案例", overlay=true)

if dayofweek == dayofweek.monday
    plot(ta.ema(close, 20), linewidth=3) // 尝试在if内部绘图

保存时，你会得到错误：“Cannot use 'plot' in local scope.”

要理解这个错误，你得先知道两个概念：

• 全局作用域：指你代码里没有缩进的“顶层”部分。在这里声明的变量、调用的函数，在每一根K线上都会被计算和执行。
• 局部作用域：指那些通过缩进形成的代码块，比如if语句、for循环或者自定义函数内部。这些代码只有在满足特定条件时才会被执行。

PineScript有个核心规定：所有负责绘图、上色、设置警报和全局风控的函数，都必须在“全局”发号施令，它们需要确保在每一根K线上都有一个确定的行为（即使是什么都不做）。你不能在“局部”的if小房间里，今天决定画这条线，明天又决定不画，这会扰乱脚本的整体渲染和计算流程。

受限函数解决方案

解决方案其实万变不离其宗，核心思想就是：不要在if里决定‘是否执行’，而是在if（或更简洁的三元运算符?:）里决定‘执行的参数’。

对于所有绘图和上色函数，它们的解决方案都遵循同一个模式：用if/else或三元运算符?:准备一个变量。当条件满足时，给这个变量赋予你想绘制的值或颜色；当条件不满足时，给它赋一个na（代表‘空’或‘不绘制’）。最后，把这个变量传给“全局”的绘图函数。

下面是常见受限函数及其解决方案清单：

• plot(), plotbar(), plotcandle()
  • 限制：不能在if内调用。
  • 解决方案：将其要绘制的series（系列）或open, high, low, close等参数，通过条件设为具体值或na。

    // 案例：仅当收盘价高于SMA时，才绘制SMA
    smaValue = ta.sma(close, 20)
    valueToPlot = close > smaValue ? smaValue : na
    plot(valueToPlot, title="条件SMA", linewidth=2)
    

• barcolor(),bgcolor()
  • 限制：不能在if内调用。
  • 解决方案：将其color（颜色）参数，通过条件设为具体颜色值或na。

    // 案例：当收盘价上涨时，K线变橙色
    barcolor(close > close[1] ? color.orange : na)
    

• plotshape(),plotchar()
  • 限制：不能在if内调用。
  • 解决方案：将其第一个series（系列）参数，通过条件设为true（绘制）或false/na（不绘制）。

    // 案例：当价格高于EMA时，绘制一个菱形
    plotshape(close > ta.ema(close, 10), style=shape.diamond, title="收盘价高于EMA")
    

• plotarrow()
  • 限制：不能在if内调用。
  • 解决方案：将其第一个series（系列）参数，通过条件设为正数（向上箭头）、负数（向下箭头）或0/na（不绘制）。

    // 案例：当创20周期新高时，绘制向上箭头
    newHigh = high > ta.highest(high, 20)[1]
    plotarrow(newHigh ? 1 : 0, title="新高箭头")
    

• hline()
  • 限制：完全不能在if内使用，也无法条件性地改变其值。
  • 解决方案：放弃使用hline()，改用plot()函数来模拟。这是绘制条件性水平线的标准方法。

    // 案例：仅当收盘价高于SMA时，才在SMA价位画一条水平线
    smaValue = ta.sma(close, 20)
    plot(close > smaValue ? smaValue : na, color=color.blue, style=plot.style_line, title="条件水平线")
    

• alertcondition()
  • 限制：不能在if内调用。
  • 解决方案：该函数自带condition参数，直接把布尔条件传给它即可。

    alertcondition(condition=close > close[1], message="收盘价上涨")
    

• 策略风控函数 (strategy.risk.*)
  • 限制：完全不能在if内调用，其参数也不能动态设定。
  • 解决方案：目前没有。这些是“一次性”的全局规则，一旦设定，在整个策略运行期间都有效。

关于受限函数的解决方案大致是这些，都是比较基础入门的小问题，后面跟随学长正式进入pine语言的世界，一起学习如何在TV图表上绘制指标。