語言基礎

每個 Navi 腳本都以聲明語句開頭：indicator()、strategy() 或 library()。

腳本結構

indicator("My Indicator");

// 你的代碼
plot(close);

Navi 使用大括號塊 { } 和分號 ; 來終止語句。換行符無意義——你可以自由地拆分或合併行。

註釋

// 單行註釋
let a: float = 10; // 行尾註釋

沒有多行註釋。以 //@ 開頭的特殊註釋是文件標籤：//@function、//@param、//@returns、//@type、//@enum、//@field、//@variable、//@description。

語句

每條語句以 ; 結尾。換行符無意義——多條語句可以在同一行，單條語句可以跨多行：

let a = 1; let b = 2; let c = a + b;   // 同一行多條語句

let result = longVariableName           // 跨行拆分
    + anotherLongVariable
    - someOtherValue;

以右大括號 } 結尾的語句（函數、if/for/while 等）不需要在末尾加 ;。

基本類型

原始類型

類型	描述	示例
int	整數	42, -123, +5
float	浮點數	3.14, .5, 3., 1e-3
bool	布林值	true, false
string	文字	"hello", 'world'
color	RGBA 顏色	#FF0000, #FF000080
na	缺失/未定義值	na

int 和 float

let a = 42;
let b = -123;
let d = 3.14;
let e = .14;        // 前導點
let f = 3.;         // 尾隨點
let g = 314e-2;     // 3.14

string

字串可以使用單引號或雙引號，語義完全相同：

let a = "Hello, World!";
let b = 'Hello, World!';
let full = "Hello, " + "World!";  // 用 + 連接字串

支援的轉義序列：

轉義	含義
\\	反斜槓
\n	換行
\r	回車
\t	Tab
\" 或 ""	雙引號（在雙引號字串中）
\' 或 ''	單引號（在單引號字串中）

color

顏色字面量使用 # 的十六進制表示法：

• #RRGGBB — 6 位十六進制，完全不透明
• #RRGGBBAA — 8 位十六進制，顯式 alpha 通道

let red     = #FF0000;       // 完全不透明的紅色
let semiRed = #FF000080;     // 半透明紅色

命名顏色常量：color.RED、color.BLUE、color.GREEN 等。使用 color.new() 建立自訂透明度的顏色。

na

na 表示缺失或未定義的值。它與任何類型兼容，但單獨使用時需要顯式類型注解：

let a: float = na;  // OK
let b = na;         // 錯誤：無法推斷類型

if na(myValue) {
    // 處理缺失值
}

運算子

算術運算

let a = 10 + 3;   // 13
let b = 10 - 3;   // 7
let c = 10 * 3;   // 30
let d = 10 / 3;   // 3.333...
let e = 10 % 3;   // 1

比較運算

close > open     // 大於
close < open     // 小於
close >= 100     // 大於等於
close <= 100     // 小於等於
close == open    // 等於
close != open    // 不等於

邏輯運算

a and b    // 邏輯與
a or b     // 邏輯或
not a      // 邏輯非

三元運算

let col = close > open ? color.GREEN : color.RED;

下一步

• 變量與限定符 — 類型限定符、var/varip、na 處理
• 歷史引用 — 使用 [] 存取過去 K 線的值
• 集合 — array、map、matrix
• 控制結構 — if、for、while、switch
• 函數與方法 — 定義和調用函數