GoLand 2025.2 Help

Stylelint

GoLand 集成了 Stylelint ,因此您可以在 IDE 中检查 CSS 代码。 Stylelint 会在您编辑 CSS 文件时自动激活,并突出显示检测到的问题,详见下方的 Lint 您的代码

除 CSS 外,您还可以通过应用 customSyntax 来验证其他样式表,详见下方的 Lint 非 CSS 样式表

开始之前

  1. 下载并安装 Node.js

  2. 请确保您的项目中已配置本地 Node.js 解释器:打开 设置 对话框(Ctrl+Alt+S ),然后转到 语言和框架 | Node.jsNode 解释器(I) 字段显示项目的默认 Node.js 解释器。

安装 Stylelint

  • 打开内置 终端Alt+F12 ),然后输入:

    npm install --save-dev stylelint stylelint-config-standard

这将安装 Stylelint 及其 standard configuration。 详细信息请参见 Stylelint 官网

启用并配置 Stylelint

  1. 要启用 Stylelint,打开 设置 对话框(Ctrl+Alt+S ),转到 语言与框架 | 样式表 | Stylelint ,并选择 启用 复选框。 之后对话框中的控件将可用。

  2. Stylelint 包 字段中,指定全局或当前项目中安装的 stylelint 软件包的位置。 如果您采用标准安装流程,GoLand 会自动检测该软件包。

  3. 针对文件运行 字段中,指定定义待 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>/**/*

      假设您有如下结构的项目:

      Stylelint:自定义模式。 示例项目结构

      如需仅对 styles 文件夹中的 CSS 和 SCSS 文件进行 Lint,请如下更新模式:

      styles/*.{css,scss}

      结果为, styles.css lint_scss.scss 文件会被 Lint,而 no_lint_scss.scss 则不会。

  4. 可选:

    配置文件 字段中,指定您的配置文件位置。

    默认情况下,该字段为空,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 ,并启用 保存时运行 stylelint --fix 复选框。

Lint 您的代码

Stylelint 会在您编辑样式表文件时自动激活,并高亮显示检测到的问题。

  • 要在弹出窗中查看问题描述,请将鼠标悬停在高亮代码上。

  • 在不产生歧义的情况下,Stylelint 可通过 Stylelint Auto Fix 功能自动修复当前文件中检测到的问题。 要应用自动修复,请在弹出窗口中点击 Stylelint:修复当前文件

    或者按 Alt+Enter ,然后从列表中选择 Stylelint:修复当前文件

Lint 非 CSS 样式表

若要检查非 CSS 的样式表,您需要直接使用 customSyntax ,或使用社区共享的配置。 请访问 Stylelint 官方网站了解更多信息。

  1. 根据您要检查的样式表类型安装 stylelint 以及相应的共享配置,例如 SCSS:

    npm install --save-dev stylelint stylelint-config-standard-scss

    请访问 Stylelint 官方网站了解可用的共享配置。

  2. 打开您的 Stylelint 配置文件,并添加一个 extends 字段,其内容如下:

    { "extends": "<shared config>" }

    例如:

    { "extends": "stylelint-config-standard-scss" }
最后修改日期: 2025年 9月 26日