Stylelint
GoLand 集成了 Stylelint ,因此您可以在 IDE 中检查 CSS 代码。 Stylelint 会在您编辑 CSS 文件时自动激活,并突出显示检测到的问题,详见下方的 Lint 您的代码。
除 CSS 外,您还可以通过应用 customSyntax 来验证其他样式表,详见下方的 Lint 非 CSS 样式表。
开始之前
下载并安装 Node.js。
请确保您的项目中已配置本地 Node.js 解释器:打开 设置 对话框(Ctrl+Alt+S ),然后转到 。 Node 解释器(I) 字段显示项目的默认 Node.js 解释器。
安装 Stylelint
打开内置 终端 (Alt+F12 ),然后输入:
npm install --save-dev stylelint stylelint-config-standard
这将安装 Stylelint 及其 standard configuration。 详细信息请参见 Stylelint 官网。
启用并配置 Stylelint
要启用 Stylelint,打开 设置 对话框(Ctrl+Alt+S ),转到 语言与框架 | 样式表 | Stylelint ,并选择 启用 复选框。 之后对话框中的控件将可用。
在 Stylelint 包 字段中,指定全局或当前项目中安装的 stylelint 软件包的位置。 如果您采用标准安装流程,GoLand 会自动检测该软件包。
在 针对文件运行 字段中,指定定义待 Lint 文件集的模式。 默认情况下,Stylelint 仅处理普通 CSS 文件,因此默认模式为
**/*.{css}。要对其他类型或特定文件夹中的文件进行 Lint,请使用 glob patterns 来更新默认模式。 要对其他类型的文件进行 Lint,也可使用自定义配置,详见下方 Lint 非 CSS 样式表。
例如,如需对 HTML、Vue、SCSS、Styled Components、JavaScript、TypeScript、JSX 和 TSX 进行 Lint,请如下更新默认模式:
**/*.{html,vue,css,scss,js,ts,jsx,tsx}要对特定文件夹(包含子文件夹)中的文件进行 Lint,请将
**/*替换为<path to the folder>/**/*。假设您有如下结构的项目:

如需仅对 styles 文件夹中的 CSS 和 SCSS 文件进行 Lint,请如下更新模式:
styles/*.{css,scss}结果为, styles.css 和 lint_scss.scss 文件会被 Lint,而 no_lint_scss.scss 则不会。
可选:
在 配置文件 字段中,指定您的配置文件位置。
默认情况下,该字段为空,GoLand 将使用 Stylelint 的原生机制自动检测配置。 使用该自动检测模式时,Stylelint 会向上遍历文件夹结构,查找以下方式定义的配置:
通过
stylelint文件中的 package.json 属性。在 .stylelintrc.json 、 .stylelintrc.yaml 、 .stylelintrc.yml 或 .stylelintrc.js 文件中。
在导出 JavaScript 对象的 stylelint.config.js 文件中。
在导出 JavaScript 对象的 stylelint.config.cjs 文件中。 运行 JavaScript 中的 Stylelint 时,将使用其
"type":"module"属性的 package.json 中的配置包。
详细信息请参见 Stylelint 官网。
要使用自定义配置文件,请点击
图标,在 配置文件 字段中选择所需配置文件的路径。
保存时自动修复问题
Stylelint 可在保存更改时修复检测到的问题,无论是通过 Ctrl+S 手动保存,还是在运行/调试配置、关闭 GoLand 或执行版本控制操作时自动保存。详细信息,请参见 自动保存。
打开 设置 对话框(Ctrl+Alt+S ),转到 ,并启用 保存时运行 stylelint --fix 复选框。
Lint 您的代码
Stylelint 会在您编辑样式表文件时自动激活,并高亮显示检测到的问题。
要在弹出窗中查看问题描述,请将鼠标悬停在高亮代码上。
在不产生歧义的情况下,Stylelint 可通过 Stylelint Auto Fix 功能自动修复当前文件中检测到的问题。 要应用自动修复,请在弹出窗口中点击 Stylelint:修复当前文件。
或者按 Alt+Enter ,然后从列表中选择 Stylelint:修复当前文件。
Lint 非 CSS 样式表
若要检查非 CSS 的样式表,您需要直接使用 customSyntax ,或使用社区共享的配置。 请访问 Stylelint 官方网站了解更多信息。
根据您要检查的样式表类型安装 stylelint 以及相应的共享配置,例如 SCSS:
npm install --save-dev stylelint stylelint-config-standard-scss请访问 Stylelint 官方网站了解可用的共享配置。
打开您的 Stylelint 配置文件,并添加一个
extends字段,其内容如下:{ "extends": "<shared config>" }例如:
{ "extends": "stylelint-config-standard-scss" }