name: dart-sass description: 提供Dart Sass的全面指导，包括Sass语法、编译、混合、函数和最佳实践。当用户询问Dart Sass、需要将Sass编译为CSS、使用Sass功能或在项目中使用Sass时使用。 license: 完整条款在LICENSE.txt文件中

何时使用此技能

当用户想要：

安装和配置Dart Sass
将Sass/SCSS文件编译为CSS
使用Sass语法特性（变量、嵌套、混合、函数等）
使用Sass模块和导入
将Sass集成到构建工具或工作流中
使用Sass CLI命令
配置Sass编译选项
在JavaScript或Dart项目中使用Sass
优化Sass编译性能
处理Sass源映射

如何使用此技能

使用Dart Sass：

安装Dart Sass:
- 加载 examples/getting-started/installation.md 以获取安装说明
- 加载 examples/getting-started/basic-usage.md 以获取基本使用示例
- 加载 examples/getting-started/compiling-modes.md 以获取不同的编译模式
学习Sass语法:
- 加载 examples/syntax/variables.md 以了解变量使用
- 加载 examples/syntax/nesting.md 以了解嵌套语法
- 加载 examples/syntax/mixins.md 以了解混合
- 加载 examples/syntax/functions.md 以了解函数
- 加载 examples/syntax/operators.md 以了解运算符
- 加载 examples/syntax/at-rules.md 以了解at规则
使用高级特性:
- 加载 examples/features/modules.md 以了解模块系统
- 加载 examples/features/imports.md 以了解导入
- 加载 examples/features/control-flow.md 以了解控制流
- 加载 examples/features/built-in-modules.md 以了解内置模块
- 加载 examples/features/source-maps.md 以了解源映射
- 加载 examples/features/custom-functions.md 以了解自定义函数
需要时参考API文档:
- api/js-api.md - JavaScript API参考
- api/dart-api.md - Dart API参考
- api/cli-api.md - CLI命令参考
使用模板快速开始:
- templates/basic-project.md - 基础Sass项目模板
- templates/modular-project.md - 模块化Sass项目模板
- templates/build-integration.md - 构建工具集成模板

文档映射（与官方文档一一对应）

examples/ → https://sass-lang.com/documentation/

示例和模板

此技能包含详细示例，组织以匹配官方文档结构。所有示例都在 examples/ 目录中（见上方映射）。

使用示例：

从用户请求中识别主题
从上方映射加载相应的示例文件
遵循该文件中的说明、语法和最佳实践
根据您的具体用例调整代码示例

使用模板：

参考 templates/ 目录中的模板以进行常见搭建
根据您的具体需求和编码风格调整模板

API参考

JavaScript API: api/js-api.md - 用于编译Sass的JavaScript API（compile, compileString等）
Dart API: api/dart-api.md - 用于编译Sass的Dart API
CLI API: api/cli-api.md - 命令行界面选项和用法

最佳实践

使用@use代替@import：@import规则已弃用，请使用@use和@forward代替
用模块组织：使用模块系统来组织和共享代码
优化编译：使用适当的输出样式（生产环境使用压缩）
源映射：开发时启用源映射，生产时禁用
监视模式：开发时使用–watch以在更改时自动重新编译
加载路径：使用–load-path来简化导入路径
性能：使用Dart Sass以获得最佳性能（比Ruby Sass更快）
版本控制：不要提交编译后的CSS文件，只提交Sass源文件

资源

官方网站: https://sass-lang.com/dart-sass/
安装指南: https://sass-lang.com/install/
文档: https://sass-lang.com/documentation/
GitHub仓库: https://github.com/sass/dart-sass
npm包: https://www.npmjs.com/package/sass
pub.dev包: https://pub.dev/packages/sass

关键词

dart-sass, sass, scss, css预处理器, sass编译器, sass语法, sass模块, sass混合, sass函数, sass变量, sass嵌套, @use, @forward, @import, @include, @mixin, @function, sass:math, sass:color, sass:string, 源映射, sass cli, sass api, 样式预处理器, Sass 编译器, Sass 语法, Sass 模块, Sass 混合, Sass 函数