如何在IntelliJ中配置Spectral Lint检查全项目YAML/JSON文件？

一、先安装Spectral CLI #

首先确保本地全局安装Spectral，打开终端执行：

npm install -g @stoplight/spectral-cli

验证安装成功：

spectral --version

二、在IntelliJ中配置外部工具 #

1. 打开IntelliJ设置面板：File > Settings（Windows/Linux）或IntelliJ IDEA > Settings（Mac）
2. 导航到Tools > External Tools，点击右上角+按钮新建工具
3. 在配置窗口中填写以下内容：
   • Name：自定义名称，比如「Spectral 批量检查」
   • Program：输入spectral（已加入系统环境变量时）；未加入则填全局安装路径，Windows示例：C:\Users\<你的用户名>\AppData\Roaming\npm\spectral.cmd，Mac/Linux示例：/usr/local/bin/spectral
   • Arguments：lint $ProjectFileDir$/**/*.{yaml,yml,json}，该参数会扫描项目根目录下所有YAML/JSON文件
   • Working directory：选择$ProjectFileDir$（项目根目录）
   • 可选：勾选「Open console for tool output」，方便直接查看检查结果
4. 点击OK保存配置

三、执行批量检查 #

1. 在IntelliJ的Project视图中，选中要检查的项目根目录（或特定子目录）
2. 右键点击，在菜单中选择External Tools > 你自定义的工具名
3. 等待终端执行完成，即可查看所有文件的Spectral检查结果，包括错误、警告信息及对应文件路径

额外提示 #

• 若仅需检查特定目录，将Arguments中的$ProjectFileDir$替换为$SelectedPath$，选中子目录时就只扫描该目录下的文件
• 可给工具设置快捷键：在Settings > Keymap中搜索工具名称，添加自定义快捷键

内容的提问来源于stack exchange，提问作者VEER SINGH