# @getkist/action-sass 中文文档

规范地址：https://npmcn.com/package/%40getkist/action-sass/

版本：1\.0\.28
npm 元数据更新时间：2026-10-09T08:06:49.803Z
中文译文更新时间：2026-11-16T10:10:43.614Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40getkist/action-sass
原文对照：https://npmcn.com/package/%40getkist/action-sass/?lang=original
项目主页：https://github.com/getkist/kist-action-sass#readme
源码仓库：https://github.com/getkist/kist-action-sass

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

- 包体积（解压后）：120 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：4 个
- peer 依赖：kist \>=0\.1\.58
- 首次发布：2026-02-08T19:49:55.623Z
- 最新版本发布：2026-10-09T08:06:49.573Z
- 近 30 天下载量：2216（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

使用 PostCSS 处理 kist 构建工具的行动汇编 SAS/SCSS

## 安装

```sh
npm install @getkist/action-sass
```

也可以使用：`pnpm add @getkist/action-sass`、`yarn add @getkist/action-sass`、`bun add @getkist/action-sass`

## README

# @ getkist/ action- sass (英语)

[![npm version](https://img.shields.io/npm/v/@getkist/action-sass?style=flat-square&logo=npm&logoColor=FFFFFF&labelColor=5e4d34&color=5e4d34)](https://www.npmjs.com/package/@getkist/action-sass) [![CI](https://img.shields.io/github/actions/workflow/status/getkist/kist-action-sass/ci.yml?style=flat-square&logo=githubactions&logoColor=FFFFFF&label=CI&labelColor=5e4d34&color=5e4d34)](https://github.com/getkist/kist-action-sass/actions/workflows/ci.yml) [![Coverage](https://img.shields.io/codecov/c/github/getkist/kist-action-sass?style=flat-square&logo=codecov&logoColor=FFFFFF&label=Coverage&labelColor=5e4d34&color=5e4d34)](https://codecov.io/gh/getkist/kist-action-sass) [![License: MIT](https://img.shields.io/badge/License-MIT-5e4d34?style=flat-square)](https://opensource.org/licenses/MIT) [![kist plugin](https://img.shields.io/badge/kist-plugin-5e4d34?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMiAyTDIgN3Y2YzAgNS41NSAzLjg0IDEwLjc0IDEwIDEyIDYuMTYtMS4yNiAxMC02LjQ1IDEwLTEyVjdMMTIgMnoiLz48L3N2Zz4=)](https://github.com/getkist/kist)

SASS/SCSS 汇编和PostCSS处理 [键](https://github.com/getkist/kist) 构建工具.

## 特征

-   **SAS/SCSS 汇编** - 使用 Dart Sass 的现代 SAS 汇编
-   **后CSS 整合** - 用自动前置器自动处理 PostCSS
-   **压缩支持** - 扩大和压缩输出样式
-   **CSS 优化** - 内置Csnano以进行微缩
-   **节点软件包导入器** - 从节点直接导入

## 安装

```bash
npm install --save-dev @getkist/action-sass
```

## 使用量

### 基本样式汇编

添加到您的 `kist.yml`数字 :

```yaml
pipeline:
    stages:
        - name: styles
          steps:
              - name: compile-styles
                action: StyleProcessingAction
                options:
                    inputFile: ./src/styles/main.scss
                    outputFile: ./dist/styles/main.css
                    styleOption: compressed
```

### 扩展输出

```yaml
pipeline:
    stages:
        - name: dev-styles
          steps:
              - name: compile-dev-styles
                action: StyleProcessingAction
                options:
                    inputFile: ./src/styles/app.scss
                    outputFile: ./dist/styles/app.css
                    styleOption: expanded
```

## 动作:处理样式

通过 PostCSS 转换将 SCSS 文件编译为 CSS .

### 选项

| 选项 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| `inputFile` | 字符串 | 对 | 输入 SCSS 文件的路径 |
| `outputFile` | 字符串 | 没有 | 单输出 CSS 文件路径( 互为专属 ) `outputs`(中文(简体) ) |
| `styleOption` | 字符串 | 没有 | 单一输出样式 : “ 扩展” 或 “ 压缩 ” ( 互为独家 ) `outputs`(中文(简体) ) |
| `outputs` | `StyleOutputConfig[]` | 没有 | 单一投入的多种产出,例如扩大和压缩CSS(相互排斥与 `outputFile`编号 :`styleOption`(中文(简体) ) |
| `sourceMap` | 布尔 | 没有 | 启用单一输出模式的源映射生成( 默认 ): `false`(中文(简体) ) |
| `sourceMapIncludeSources` | 布尔 | 没有 | 在源图中包含原始源内容( 默认 ): `true` 何时 `sourceMap` 已启用) |

### 处理特性

**扩展模式 :**

-   可读、可格式化 CSS 输出
-   用于浏览器兼容性的自动前置器
-   发展的理想

**压缩模式 :**

-   已缩小的 CSS 和 csnano
-   用于浏览器兼容性的自动前置器
-   优化生产

### PostCSS 插件

-   **自动前置器** - 自动添加供应商前缀
-   **克斯纳诺** - CSS分解(只压缩模式)

## 实例

### 多样式文件

```yaml
pipeline:
    stages:
        - name: compile-all-styles
          steps:
              - name: main-styles
                action: StyleProcessingAction
                options:
                    inputFile: ./src/styles/main.scss
                    outputFile: ./dist/styles/main.css
                    styleOption: compressed

              - name: admin-styles
                action: StyleProcessingAction
                options:
                    inputFile: ./src/styles/admin.scss
                    outputFile: ./dist/styles/admin.css
                    styleOption: compressed
```

### 开发与生产

```yaml
pipeline:
    stages:
        - name: dev-build
          steps:
              - name: dev-styles
                action: StyleProcessingAction
                options:
                    inputFile: ./src/styles/app.scss
                    outputFile: ./dist/dev/app.css
                    styleOption: expanded

        - name: prod-build
          steps:
              - name: prod-styles
                action: StyleProcessingAction
                options:
                    inputFile: ./src/styles/app.scss
                    outputFile: ./dist/prod/app.css
                    styleOption: compressed
```

### 单个输入的多个产出

使用 `outputs` 在一个步骤中从一个单一的SCSS源生成几个CSS文件(如扩展和压缩):

```yaml
pipeline:
    stages:
        - name: styles
          steps:
              - name: compile-styles
                action: StyleProcessingAction
                options:
                    inputFile: ./src/styles/app.scss
                    outputs:
                        - file: ./dist/css/app.css
                          style: expanded
                          sourceMap: true
                        - file: ./dist/css/app.min.css
                          style: compressed
```

## 类型脚本

```typescript
import { StyleProcessingAction } from "@getkist/action-sass";

const action = new StyleProcessingAction();
```

### 样式处理操作选项

```typescript
interface StyleOutputConfig {
    file: string;
    style: "expanded" | "compressed";
    sourceMap?: boolean;
}

interface StyleProcessingActionOptions {
    inputFile: string;
    outputFile?: string;
    styleOption?: "expanded" | "compressed";
    outputs?: StyleOutputConfig[];
    sourceMap?: boolean;
    sourceMapIncludeSources?: boolean;
}
```

## 所需资源

-   节点.js 22.0.0
-   npm = 10.0.0 (韩语)
-   1.1.58 (韩语)

## 捐款

见 [捐款额](https://npmcn.com/package/%40getkist/action-sass/CONTRIBUTING.md) 捐款准则.

## 许可证

麻省理工学院

## 链接

-   [GitHub 仓库](https://github.com/getkist/kist-action-sass)
-   [npm 软件包](https://www.npmjs.com/package/@getkist/action-sass)
-   [kist 构建工具](https://github.com/getkist/kist)
-   [问题跟踪器](https://github.com/getkist/kist-action-sass/issues)

## 常见问题

### @getkist/action-sass 是什么？

使用 PostCSS 处理 kist 构建工具的行动汇编 SAS/SCSS

### 如何安装 @getkist/action-sass？

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

### @getkist/action-sass 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @getkist/action-sass 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @getkist/action-sass 需要什么版本的 Node\.js？

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

### @getkist/action-sass 可以商用吗？

@getkist/action-sass 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @getkist/action-sass 的下载量有多少？

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

### @getkist/action-sass 还在维护吗？

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

