安装与使用 Navi

Navi 可以在多种环境中使用，请根据实际工作流选择：

使用环境	适用场景
Longbridge App 或桌面端	直接在交易图表中使用指标和策略
Longbridge CLI	使用 Longbridge 行情数据运行脚本、自动化、选股和回测
navi CLI	本地编写、格式化、类型检查、调试和 CI 验证

日常和正式使用时，建议选择 Longbridge App、桌面端或 Longbridge CLI。独立的 navi CLI 主要是开发工具，不能替代 Longbridge 产品中的完整使用体验。

Longbridge App 和桌面端

需要在图表中交互式使用 Navi 时，请使用 Longbridge App 或桌面端。Navi 运行时已经集成在产品中，无需另行安装 Navi CLI。

下载 Longbridge

Longbridge CLI

需要通过命令行使用 Longbridge 服务和行情数据时，请安装 Longbridge CLI。

按照 Longbridge CLI 安装指南完成安装，然后登录：

longbridge auth login

接下来可前往快速开始，编写脚本并使用 Longbridge 行情数据运行。完整命令选项请参阅 longbridge quant run 文档。

用于开发的 Navi CLI

在本地开发或调试 .nv 文件，或者在 CI 中验证脚本时，可以安装独立的 navi CLI。

macOS 或 Linux：

curl -fsSL https://navi-lang.org/install.sh | sh

Windows PowerShell：

irm https://navi-lang.org/install.ps1 | iex

确认安装：

navi --version

独立 CLI 不包含行情数据，但可以执行脚本：navi check 和 navi fmt 提供编译和格式化检查，navi run 则用你从 stdin 以 NDJSON 提供的数据执行脚本，把每根 K 线的 plot 数值和告警写到 stdout。navi check 和 navi fmt 都接受文件、目录和 glob 模式，一条命令即可校验整个项目。运行 navi update 可原地升级二进制。

VS Code 扩展

Navi VS Code 扩展为 .nv 文件提供语法高亮、诊断、补全、悬停提示、跳转定义和格式化。它内置了 WebAssembly 语言服务器，无需额外安装即可使用——在网页版 VS Code（vscode.dev / github.dev）中也能运行。

下载 VS Code 扩展（.vsix）

通过命令行安装：

code --install-extension navi-vscode.vsix

或在 VS Code 中：打开扩展视图，点击 ··· 菜单 → 从 VSIX 安装…，选择下载的文件。

如需使用原生 navi-lsp 可执行文件而非内置的 WebAssembly 服务器，将 navi.server.mode 设为 native，并把 navi.server.path 指向该可执行文件。

下一步

• 快速开始 — 编写并验证第一个 Navi 脚本
• 语言基础 — 学习 Navi 语法和命名规范
• AI 助手 — 安装 Navi 编写 skill