AspNetCore.SassCompiler 项目下载及安装教程

1. 项目介绍

AspNetCore.SassCompiler 是一个针对 .NET Core 3.1/5/6/x/7/x 的 Sass 编译库，它无需使用 Node.js 即可编译 Sass 文件。本项目使用 dart-sass 作为编译器，支持在 ASP.NET Core 应用程序中自动编译 Sass 文件到 CSS。

2. 项目下载位置

该项目托管在 GitHub 上，你可以通过以下地址访问项目仓库：

https://github.com/koenvzeijl/AspNetCore.SassCompiler.git

3. 项目安装环境配置

在开始安装之前，请确保你的开发环境已经安装了以下软件：

• .NET Core SDK
• Git

以下是一个典型的环境配置界面示例：

# 示例图片描述：显示已安装的 .NET Core SDK 版本和 Git 版本

.NET Core SDK 版本：5.0.401
Git 版本：2.30.1

4. 项目安装方式

通过 NuGet 包管理器安装

打开你的 .NET Core 项目，使用 NuGet 包管理器控制台执行以下命令：

Install-Package AspNetCore.SassCompiler

通过 .NET CLI 安装

你也可以在项目目录下使用 .NET CLI 命令来安装：

dotnet add package AspNetCore.SassCompiler

5. 项目处理脚本

安装完成后，你需要在 appsettings.json 或者 sasscompiler.json 中配置 Sass 编译器相关设置。以下是一个配置示例：

{
  "SassCompiler": {
    "Source": "Styles",
    "Target": "wwwroot/css",
    "Arguments": "--style=compressed",
    "GenerateScopedCss": true,
    "ScopedCssFolders": ["Views", "Pages", "Shared", "Components"],
    "IncludePaths": [],
    "Compilations": [
      {
        "Source": "wwwroot/scss/site.scss",
        "Target": "wwwroot/css/site.min.css"
      },
      {
        "Source": "Lib/Styles",
        "Target": "wwwroot/lib/css"
      }
    ],
    "Configurations": {
      "Debug": {
        "Arguments": "--style=expanded"
      }
    }
  }
}

确保在 Startup.cs 文件中配置了 Sass 文件监听服务：

public void ConfigureServices(IServiceCollection services)
{
    #if DEBUG
    services.AddSassCompiler();
    #endif
}

以上步骤完成后，即可在开发环境中使用 AspNetCore.SassCompiler 库进行 Sass 文件的编译。