@getkist/action-sass

中文文档
1.0.28发布于 2026/10/09MITTypeScriptESM + CJS近 30 天下载 2216

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

中文使用文档
文档目录19 节
  1. 特征
  2. 安装
  3. 使用量
  4. 基本样式汇编
  5. 扩展输出
  6. 动作:处理样式
  7. 选项
  8. 处理特性
  9. PostCSS 插件
  10. 实例
  11. 多样式文件
  12. 开发与生产
  13. 单个输入的多个产出
  14. 类型脚本
  15. 样式处理操作选项
  16. 所需资源
  17. 捐款
  18. 许可证
  19. 链接

@ getkist/ action- sass (英语)

npm version CI Coverage License: MIT kist plugin

SASS/SCSS 汇编和PostCSS处理 键 构建工具.

特征

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

安装

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

使用量

基本样式汇编

添加到您的 kist.yml数字 :

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

扩展输出

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(中文(简体) )
outputsStyleOutputConfig[]没有单一投入的多种产出,例如扩大和压缩CSS(相互排斥与 outputFile编号 :styleOption(中文(简体) )
sourceMap布尔没有启用单一输出模式的源映射生成( 默认 ): false(中文(简体) )
sourceMapIncludeSources布尔没有在源图中包含原始源内容( 默认 ): true 何时 sourceMap 已启用)

处理特性

扩展模式 :

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

压缩模式 :

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

PostCSS 插件

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

实例

多样式文件

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

开发与生产

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文件(如扩展和压缩):

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

类型脚本

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

const action = new StyleProcessingAction();

样式处理操作选项

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 (韩语)

捐款

见 捐款额 捐款准则.

许可证

麻省理工学院

版本与发布记录

@getkist/action-sass 共发布 9 个版本,首次发布于 2026/02/09;过去 12 个月发布了 9 个版本。

版本发布日期距今
1.0.28latest2026/10/091 个月前
1.0.232026/04/236 个月前
1.0.92026/02/109 个月前
1.0.72026/02/099 个月前
1.0.52026/02/099 个月前
1.0.42026/02/099 个月前

关于 @getkist/action-sass 的常见问题

@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 和提交记录判断。