# @gossi/config-stylelint 中文文档

规范地址：https://npmcn.com/package/%40gossi/config-stylelint/

版本：1\.1\.5
npm 元数据更新时间：2026-10-25T08:48:31.020Z
中文译文更新时间：2026-11-17T17:40:33.363Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gossi/config-stylelint
原文对照：https://npmcn.com/package/%40gossi/config-stylelint/?lang=original
源码仓库：https://github.com/gossi/frontend-configs

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5.1 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：4 个
- peer 依赖：stylelint ^17\.0\.0
- 首次发布：2022-08-07T14:26:05.715Z
- 最新版本发布：2026-10-25T08:48:30.618Z
- 近 30 天下载量：4733（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 4 个）

## 中文简介

暂无中文简介

## 安装

```sh
npm install @gossi/config-stylelint
```

也可以使用：`pnpm add @gossi/config-stylelint`、`yarn add @gossi/config-stylelint`、`bun add @gossi/config-stylelint`

## README

# `@gossi/config-stylelint`

将样式lint添加到您的软件包中.

## 安装

1.  安装这些软件包 :
    
    ```sh
    pnpm add -D @gossi/config-stylelint stylelint
    ```
    
2.  创建 `stylelint.config.(m)js` 使用这些内容配置文件 :
    
    ```js
    export { default } from '@gossi/config-stylelint';
    ```
    
    说明: `.mjs` 扩展为 CJS 软件包 `.js` 扩展名 软件包 `"type": "module"`。 。 。 .
    
3.  添加脚本执行 Linting
    
    ```json
    {
      "scripts": {
        "lint:css": "stylelint \"path/to/css/**/*.css\" --allow-empty-input --cache",
        "lint:css:fix": "stylelint \"path/to/css/**/*.css\" --allow-empty-input --fix"
      }
    }
    ```
    

## 配置

`@gossi/config-stylelint` 提供一个小配置选项( 对于目标) 浏览器,更改您的 `stylelint.config.(m)js` 使用此选项:

```js
import { browsers } from 'path/to/your/browsers/config';

import { configure } from '@gossi/config-stylelint';

export default configure({ browsers });
```

## 延长

要用更多的规则来扩展配置,这里是怎样在您的 `stylelint.config.(m)js`数字 :

```js
import config from '@gossi/config-stylelint';

export default {
  ...config,
  rules: {
    ...config.rules,
    'function-no-unknown': [
      true,
      {
        ignoreFunctions: ['$']
      }
    ]
  }
};
```

用于配置 `@gossi/config-stylelint`数字 :

```js
import { browsers } from 'path/to/your/browsers/config';

import { configure } from '@gossi/config-stylelint';

const config = configure({ browsers });

export default {
  ...config,
  rules: {
    ...config.rules,
    'function-no-unknown': [
      true,
      {
        ignoreFunctions: ['$']
      }
    ]
  }
};
```

## 在 vscode 中使用

建议 [正式样式lint 扩展](https://marketplace.visualstudio.com/items?itemName=stylelint.vscode-stylelint) (参考更多选项).

如果扩展找不到 `stylelint.config.(m)js` 独自一人, 每个 repo 配置、 创建或编辑 `.vscode/settings.json` (如果这是 单列波,然后在根上足够适合所有包:

```json
{
  "stylelint.configFile": "path/to/stylelint.config.(m)js",
  "stylelint.configBasedir": "path/to/",
  "stylelint.packageManager": "pnpm"
}
```

## 常见问题

### 如何安装 @gossi/config-stylelint？

在项目目录运行 npm install @gossi/config-stylelint，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：stylelint（^17\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gossi/config-stylelint 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/gossi\_\_config-stylelint 是否存在。

### @gossi/config-stylelint 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @gossi/config-stylelint 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @gossi/config-stylelint 可以商用吗？

@gossi/config-stylelint 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @gossi/config-stylelint 的下载量有多少？

根据 npm 官方下载统计，@gossi/config-stylelint 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,733 次，日均约 158 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gossi/config-stylelint 还在维护吗？

最新版本 1\.1\.5 发布于 2026/10/25（23 天前）；至今共发布 28 个版本，其中过去 12 个月发布了 4 个；首次发布于 2022/08/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

