最精简的VScode Verilog RTL开发环境搭建教程

news2024/9/25 19:21:41

【2024-9月更新】最精简的VScode Verilog RTL开发环境搭建教程

文章目录

【2024-9月更新】最精简的VScode Verilog RTL开发环境搭建教程
一、官网下载VScode
二、登录账号同步
三、安装配置拓展插件
- 1.Verilog-HDL/systemVerilog拓展
- 2.安装Universal Ctags
- - ● Windows系统安装universal ctags
  - ● Linux主流发行版安装universal ctags
- 3.配置Verilog-HDL拓展的相关参数
- - ● ctags PATH
  - ● linter（语法检查工具）
最终效果

【2024更新说明】：

本人前一版本（写于2023年）的文档过于繁琐，经过大量精简和错误修正之后，重新整理了这个版本。

*支持Verilog，systemVerilog语法

*精简了大量内容，只需一个插件就能使用

一、官网下载VScode

此步骤略。

二、登录账号同步

如果还从未使用过vscode可以暂时跳过此步。

具体操作略。

三、安装配置拓展插件

vscode本身是不支持Verilog语言开发的，要想在vscode中愉快地编写RTL，只需要安装一个插件：

其他的插件都不用安装，其余的要么没用，要么锦上添花（看个人喜好）。

1.Verilog-HDL/systemVerilog拓展

搜索安装此插件：

在这里插入图片描述

这个插件提供了Verilog开发环境的绝大多数基础功能，例如：

代码高亮（highlight）
简单语法补全提示（snippets）
静态语法检查（lint，需要自行配置linter组件）
Ctags功能集成（需要额外安装ctags组件）
- 自动补全
- 文档符号大纲
- 鼠标悬停显示代码声明
- CTRL鼠标点击跳转到代码声明
- 自动实例化模块
Language server（实验性功能）
代码自动格式化（formatting，实验性功能）

这个插件虽然是vscode拓展市场下载量最高的插件，但是部分功能仍然残缺不全，很多高级功能无法开箱即用，需要我们进一步配置（这个细节配置将在后文详细介绍。）

2.安装Universal Ctags

这是Verilog-HDL/systemVerilog拓展的依赖组件，其用途是解析工作区的文档，获取关键词目录，给vscode上下文关键词参考。

在这里插入图片描述

如图所示，这个插件依赖于 universal ctags ，在该插件的详情页有各种操作系统的ctags安装网址，对应自己的操作系统选择对应的安装方式即可。

特别注意： Verilog-HDL/SystemVerilog插件只兼容universal ctags ，并不兼容其他的ctags实现！！！

如果安装完以后，发现出现ctags索引不全，大概率安装的ctags并非这里所说的universal ctags 。

● Windows系统安装universal ctags

点击插件Verilog-HDL/SystemVerilog/Bluespec SystemVerilog详情页中的：

在这里插入图片描述

进入该网址，从release page选择最新版下载：

在这里插入图片描述

下载到本机，建议解压到一个不含空格和特殊字符的纯英文路径，例如：

在这里插入图片描述

然后将路径添加到Windows系统环境变量中的Path中，以我为例：
在这里插入图片描述

打开cmd终端，输入ctags --version，观察输出是否正常：
在这里插入图片描述

出现对应的版本信息，特别注意显示的ctags信息是universal ctags，说明安装正常，顺利结束。

● Linux主流发行版安装universal ctags

打开对应的下载官网：

在这里插入图片描述

如果你使用的Linux发行版版本较新，例如Ubuntu较新的版本，或者是Fedora较新的版本，则可以直接通过系统内置的包管理器apt install 或者dnf install。这个是最省事的。首选推荐方案！
如果你用的Linux发行版是较老的centOS或者其他不带apt或dnf工具的Linux版本，那么需要从源码安装universal ctags
- 特别注意：yum包管理器不行！！！！

从源码安装universal ctags参考官方最上面的教程：

$ git clone https://github.com/universal-ctags/ctags.git
$ cd ctags
$ ./autogen.sh
$ ./configure --prefix=/where/you/want # defaults to /usr/local
$ make
$ make install # may require extra privileges depending on where to install

注意，最后两步骤make和make install请务必在root权限下执行（加上sudo执行）！

在make install安装完成之后，ctags可执行文件将生成于$prefix/bin/路径下。默认为/usr/local/bin/ctags

同样，安装完成之后（没报错），随意在任何一个路径下打开终端，输入ctags --version观察回显是否正常。

在这里插入图片描述