Pine Script 常用語法速查
（新手版）

官方的 Pine Script 語言參考手冊有幾百個型別、變數和函式，新手一打開就想關掉。其實你九成的時間只會用到一小把。這篇把新手最常用的挑出來，每個配一句白話 + 迷你範例，當速查用。語法以 v6 為準。

1. 腳本結構（每支都要）

//@version=6              // 第一行：宣告用 v6 語法（一定要寫）
indicator("名稱", overlay=true)  // 宣告「指標」；overlay=true 畫在K線上
strategy("名稱")              // 宣告「策略」（可回測、會下單）

2. 價格資料（內建變數）

close      // 收盤價（open 開、high 高、low 低 同理）
volume     // 成交量
hl2        // =(high+low)/2　hlc3=(高+低+收)/3　ohlc4=(開高低收)/4
close[1]   // 前一根的收盤價（[] 取歷史，[2] 是前兩根）
bar_index  // 這是第幾根K棒，從 0 開始數

3. 常用技術函式（ta.*）

ta.sma(close, 20)          // 簡單移動平均（20 日均線）
ta.ema(close, 20)          // 指數移動平均
ta.rsi(close, 14)          // RSI 相對強弱指標
ta.stoch(close, high, low, 9) // KD 的 RSV
ta.crossover(a, b)        // a 由下往上穿過 b（黃金交叉）→ true
ta.crossunder(a, b)       // a 由上往下跌破 b（死亡交叉）→ true
ta.highest(high, 20)      // 近 20 根的最高價（ta.lowest 最低）

＊點前面的 ta. 是「命名空間」＝函式的分類。技術函式在 ta.、數學在 math.（如 math.max）、字串在 str.。

4. 輸入參數（input.*，做成可調設定）

len  = input.int(20, "均線天數")     // 整數輸入，預設 20
mult = input.float(2.0, "倍數")     // 小數輸入
on   = input.bool(true, "開關")     // 開關（true/false）

5. 畫圖與標記

plot(ta.sma(close,20), "MA", color=color.orange)  // 畫線
hline(70, "超買")                              // 畫水平線
plotshape(cond, style=shape.triangleup,    // 條件成立時畫箭頭
          location=location.belowbar, color=color.red)
bgcolor(cond ? color.new(color.red,90) : na) // 依條件把背景上色

6. 條件與 K 棒狀態

if ta.crossover(fast, slow)   // 條件式（下一行要縮排）
    // 這裡放條件成立要做的事

barstate.islast          // 是不是最後一根K棒 → true/false
barstate.isconfirmed     // 這根K棒是否已收盤定案
var float x = 0.0        // var：變數只在第一根初始化一次
x := close               // := 是「重新賦值」
na(close[1]) ? 0 : close[1] // na() 測有沒有值；nz(x,0) 沒值就給0

7. 策略回測（strategy.*）

strategy.entry("做多", strategy.long)   // 進場做多（strategy.short 做空）
strategy.close("做多")                  // 平掉這個部位
strategy.exit("出場", "做多", stop=90, limit=110) // 停損/停利出場
strategy.netprofit       // 目前總淨利
strategy.position_size   // 目前部位（正=多、負=空、0=空手）

把這些串起來實作，可以看 自訂指標範例 與 策略回測入門。

新手最常踩的 5 個語法雷

剛開始寫 Pine Script，卡住的通常不是邏輯，而是這幾個小地方。先知道就能少踩雷：

1. 忘了第一行 //@version=6。沒寫版本宣告，或寫成舊版號，很多新語法會直接報錯。每支腳本第一行都要有它。

2. = 和 := 搞混。= 是「第一次宣告變數」，:= 是「把新值賦回已存在的變數」。想在每根 K 棒更新同一個變數（例如遞迴計算），要用 :=，而且變數通常得先用 var 宣告，否則每根都被重置。

3. 縮排沒對齊。Pine 用縮排區分程式區塊，if 底下要做的事一定要縮排；同一區塊的縮排要一致，混用空格數量會報錯。

4. 把 indicator 和 strategy 混用。一支腳本只能宣告其中一種：要畫指標用 indicator()、要回測下單用 strategy()。strategy.entry 這類下單函式只能放在 strategy 腳本裡。

5. 拿還沒算出來的值去比較。像 close[1] 在第一根 K 棒時是沒有值的（na），直接拿去運算可能得到怪結果。用 na(x) 檢查、或 nz(x, 0) 給預設值，可以避免。