我们写好一个脚本,第一件事通常就是给它取个名字。这可不只是个代号,一个清晰、有意义的名字能让你的脚本在众多指标中脱颖而出,也方便自己日后管理和使用。
在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 平均值”:
在图表右侧的“数据窗口”里也能找到它:
打开脚本的设置窗口,标题栏同样显示着这个名字:
当基于这个指标创建警报时,“创建警报”窗口的条件选择里也会明确显示出它的名字:
这里有一个新手常搞混的地方:脚本的“显示名称”(title
) 和你保存脚本时用的“文件名”是两码事。你在TradingView社区里搜索别人的脚本时,主要搜索的是文件名。所以如果你打算公开发布自己的脚本,最好让文件名和title
保持一致或高度相关,免得别人想用却找不到。
总结
title
参数是用来给你的脚本设定显示名称的,我们通过在 indicator()
、strategy()
或 library()
函数中设置 title="你的名字"
来完成命名。每个脚本都必须有一个名字,这是Pine Script的硬性规定。