Vizsla

面向 RTL 的语言理解

读取工程清单、源文件、include 目录和宏定义，维护 Verilog/SystemVerilog 语义信息。

VS Code 内即开即用

扩展负责语言配置、语法高亮、命令、状态栏，并自动启动 bundled language server。

导航与诊断

支持语义诊断、跳转到声明/定义、引用查找、文档高亮、符号大纲和折叠。

辅助编写 RTL

提供补全、悬停说明、签名帮助、重命名、格式化、代码操作和 inlay hints。

开始阅读

快速开始 安装扩展、打开 RTL 工程、确认服务器启动，然后试用核心 IDE 功能。

安装 了解 VS Code 扩展、离线 VSIX 和自定义服务器的安装方式。

第一个工程 准备推荐目录结构，理解没有清单时的默认扫描行为。

项目配置 编写 vizsla.toml，配置 sources、include_dirs、defines 和 libraries。

常用参考

日常使用 按功能了解诊断、跳转、补全、格式化、代码操作、语义高亮和 code lens。

VS Code 设置 查阅 server、files、workspace、diagnostics、formatter 等配置项。

命令、状态栏和日志 查看命令面板命令、状态栏状态和输出通道行为。

故障排查 排查服务器启动失败、诊断不更新、文件监听和格式化问题。

更新日志 查看正式版本的破坏性更新、修复和用户可见改进。

项目组成

Vizsla 由两个部分组成:

• vizsla: Rust 编写的 LSP 服务器, 负责读取工程、解析源文件、维护语义信息并响应编辑器请求。
• editors/vscode: VS Code 扩展, 负责贡献 Verilog/SystemVerilog 语言配置、语法高亮、命令、状态栏, 并启动语言服务器。

后续我们会支持更多编辑器。

支持的文件

VS Code 扩展当前识别这些文件类型:

语言	扩展名
Verilog	.v, .vh
SystemVerilog	.sv, .svh, .svi

服务器加载工程时还会读取 .map 文件, 以支持库映射等工程输入。