---
title: "nav.index.jsonl"
type: concept
tags: ["code-navigation", "symbol-index", "LSP", "JSONL", "semantic-graph"]
sources: ["lsp-index-engineer.md"]
last_updated: 2026-04-29
---

## Definition
nav.index.jsonl 是 LSP/Index Engineer 定义的导航索引文件格式，以 JSONL（每行一条 JSON 记录）流式存储每个符号的导航信息，用于快速符号查找和代码导航服务。

## Format Specification

### Symbol Definition Record
```jsonl
{"symId":"sym:AppController","def":{"uri":"file:///src/controllers/app.php","l":10,"c":6}}
```
记录符号定义位置：`symId`（符号唯一 ID）、`def.uri`（文件 URI）、`def.l`（行号）、`def.c`（列号）

### Symbol References Record
```jsonl
{"symId":"sym:AppController","refs":[
  {"uri":"file:///src/routes.php","l":5,"c":10},
  {"uri":"file:///tests/app.test.php","l":15,"c":20}
]}
```
记录符号所有引用位置

### Hover Documentation Record
```jsonl
{"symId":"sym:useState","hover":{"contents":{"kind":"markdown","value":"```typescript\nconst [state, setState] = useState()\n```\nReact state hook"}}}
```
记录符号的悬停文档内容

## Core Properties
- **流式写入**：每次增量更新追加新记录，无需全量重建
- **原子性更新**：确保图谱从不处于不一致状态
- **快速查询**：通过 symId 直接索引，O(1) 查找
- **LSIF 兼容**：支持导入/导出 Language Server Index Format 预计算数据

## Connections
- [[nav.index.jsonl]] ← is_format_of ← [[SemanticCodeGraph]]
- [[nav.index.jsonl]] ← built_by ← [[GraphDaemon]]
- [[nav.index.jsonl]] ← uses ← [[IncrementalGraphUpdate]]
- [[nav.index.jsonl]] ← can_be_exported_as ← [[LSIF]]