保持敬畏之心
交易是一场持久战

Pine Script(40):给你的脚本取个好名字

#Pine Script入门教学

我们写好一个脚本,第一件事通常就是给它取个名字。这可不只是个代号,一个清晰、有意义的名字能让你的脚本在众多指标中脱颖而出,也方便自己日后管理和使用。

在Pine Script里,无论是指标、策略还是库,我们都通过 title 这个参数来给它命名。

基础用法

给脚本命名非常直接,我们只需要在相应的声明函数里,把 title 参数设置为你想要的名字字符串就行,别忘了用双引号把名字包起来。

对于指标,我们在 indicator() 函数里设置 title

//@version=6
indicator(title="我的指标脚本")

对于策略,则是在 strategy() 函数中设置:

//@version=6
strategy(title="我的策略脚本")

对于库,就是在 library() 函数里设置了:

//@version=6
library(title="我的库脚本")

在上面这三个函数中,title = 这部分其实是可选的,你可以省略它,直接把名字作为第一个参数传进去,代码会显得更简洁一些:

//@version=6
indicator("我的指标脚本")

不过,我个人还是建议你把 title = 显式地写上。 这样代码的可读性会更高,几个月后你再回来看自己的代码时,一眼就能明白这串字符是脚本的标题,而不是某个含糊不清的参数。

关于title参数,你需要知道的几点

必须是固定字符串:title 的值必须是一个写死的文本字符串,不能用变量来动态生成。

唯一必需的参数:在 indicator()strategy()library() 这三个函数里,title 是唯一一个必须提供的参数。所以每个脚本都必须有个名字。

最小长度:理论上名字可以只有一个字符。 但不建议这么做,对于库来说,空字符串 "" 甚至会直接报错。

最大长度:title 最多可以有128个字符。 但没人会用那么长的名字。一个好的脚本名称应该简短、清晰,能概括其核心功能。名字太长在图表上也显示不全,反而碍事。例如“结合RSI和两条均线的多空通道策略(含开盘入场及止盈止损)”这种名字就已经太啰嗦了。

库名称的特殊限制:给库命名时,规则要更严格一些。名称里不能有空格和大多数特殊字符(但下划线 _ 可以用),也不能用数字开头。 这是因为库在代码中是作为一种“引用”存在的,规范和其他编程语言的包名类似。

只能通过代码设置:脚本的名字只能在代码里通过 title 参数来设定,你没法在图表的设置界面里修改它。

你的脚本名字会出现在哪里?

一旦设置好 title,这个名字就会成为脚本在TradingView平台上的官方认证名称,出现在各个角落:

  • 图表左上角的图例中。
  • 图表右侧的“数据窗口”。
  • 脚本的“设置”窗口。
  • “创建警报”窗口。
  • 如果是策略,还会出现在“策略测试器”窗口的回测结果里。

此外,当你公开发布脚本时,title 会默认成为你作品的标题,其他用户也是通过这个名字来搜索和识别你的脚本。

实战演示

我们来看一个简单的指标,它计算并绘制RSI。我们用 title 将它命名为“RSI 平均值”。

//@version=6
indicator(title="RSI 平均值")

plot(ta.rsi(ohlc4, 9), color=color.teal, title="RSI")

在这段代码里,我们首先通过 indicator() 函数给脚本命名。 接着,用 plot() 函数来绘制周期为9的RSI指标,计算的数据源是 ohlc4(即每根K线的开、高、低、收盘价的平均值),并用青色线条显示。

当我们将这个脚本添加到图表后,马上就能在图表左上角看到它的名字“RSI 平均值”:

一个名为“RSI 平均值”的Pine脚本指标在EURUSD图表上的显示效果,标题清晰可见。

在图表右侧的“数据窗口”里也能找到它:

TradingView的数据窗口中清晰地显示了通过Pine脚本title参数设置的脚本名称“RSI 平均值”。

打开脚本的设置窗口,标题栏同样显示着这个名字:

Pine脚本的设置窗口,其标题栏显示了通过title参数设定的名称“RSI 平均值”。

当基于这个指标创建警报时,“创建警报”窗口的条件选择里也会明确显示出它的名字:

在TradingView的创建警报窗口中,条件选择下拉菜单正确显示了Pine脚本的title“RSI 平均值”。

这里有一个新手常搞混的地方:脚本的“显示名称”(title) 和你保存脚本时用的“文件名”是两码事。你在TradingView社区里搜索别人的脚本时,主要搜索的是文件名。所以如果你打算公开发布自己的脚本,最好让文件名和title保持一致或高度相关,免得别人想用却找不到。

总结

title 参数是用来给你的脚本设定显示名称的,我们通过在 indicator()strategy()library() 函数中设置 title="你的名字" 来完成命名。每个脚本都必须有一个名字,这是Pine Script的硬性规定。

赞(0)
未经允许不得转载:图道交易 » Pine Script(40):给你的脚本取个好名字
分享到

评论 抢沙发

登录

找回密码

注册