现已推出!阅读关于 11 月的新功能和修复的信息。

CSS、SCSS 和 Less

Visual Studio Code 内置支持编辑 CSS .css、SCSS .scss 和 Less .less 中的样式表。此外,您可以安装扩展以获得更强大的功能。

提示: 点击上面的扩展磁贴阅读说明和评论,以决定哪个扩展最适合您。在Marketplace中查看更多信息。

IntelliSense

VS Code 支持选择器、属性和值。使用 ⌃Space(Windows,Linux Ctrl+Space获取上下文相关的选项列表。

IntelliSense in CSS

提案包含大量的文档,包括支持该属性的浏览器列表。要查看所选条目的完整描述文本,请使用⌃Space(Windows,Linux Ctrl+Space

语法着色和颜色预览

当您输入时,会出现语法高亮显示以及颜色上下文预览。

Syntax and color

点击颜色预览将启动集成的颜色选择器,该选择器支持配置色调、饱和度和不透明度。

Color picker in CSS

提示: 您可以通过点击选择器顶部的颜色字符串在不同的颜色模式之间切换。

您可以通过设置以下设置来隐藏 VS Code 的颜色预览

"editor.colorDecorators": false

要仅针对 CSS、Less 和 SCSS 禁用它,请使用

"[css]": {
    "editor.colorDecorators": false
}

折叠

您可以使用行号和行开始之间的装订线上的折叠图标来折叠源代码区域。折叠区域适用于所有声明(例如,规则声明)和源代码中的多行注释。

此外,您可以使用以下区域标记来定义折叠区域:CSS/SCSS/Less 中的 /*#region*//*#endregion*/ 或 SCSS/Less 中的 // #region// #endregion

如果您希望为 CSS、Less 和 SCSS 切换到基于缩进的折叠,请使用

"[css]": {
    "editor.foldingStrategy": "indentation"
},

Emmet 代码片段

VS Code 内置了Emmet 缩写支持,建议与编辑器自动完成列表中的其他建议和代码片段一起列出。

提示: 有效缩写请参阅Emmet 速查表的 CSS 部分。

VS Code 还支持用户定义代码片段

语法验证和代码检查

支持 CSS 版本 <= 2.1、Sass 版本 <= 3.2 和 Less 版本 <= 2.3。

注意: 您可以通过将相应的 .validate 用户或工作区设置设置为 false 来禁用 VS Code 的默认 CSS、Sass 或 Less 验证。

"css.validate": false

转到文件中的符号

您可以通过按 ⇧⌘O(Windows,Linux Ctrl+Shift+O,在当前文件中快速导航到相关的 CSS 符号。

悬停

将鼠标悬停在选择器或属性上将提供与 CSS 规则匹配的 HTML 代码片段。

Hover in CSS

转到定义和查找引用

在同一文件中支持 Sass 和 Less 变量。还支持CSS 变量,每个草案标准提案也受支持。

CSS、SCSS 和 Less 中的 @importurl() 链接支持跳转到定义。

CSS 自定义数据

您可以通过声明式的自定义数据格式来扩展 VS Code 的 CSS 支持。通过将css.customData设置为遵循自定义数据格式的 JSON 文件列表,您可以增强 VS Code 对新 CSS 属性、指令、伪类和伪元素的理解。然后,VS Code 将为提供的属性、指令、伪类和伪元素提供语言支持,例如完成和悬停信息。

您可以在vscode-custom-data 存储库中阅读有关使用自定义数据的更多信息。

格式化

CSS 语言功能扩展还提供了一个格式化程序。该格式化程序适用于 CSS、LESS 和 SCSS。它由 JS Beautify 库实现,并带有以下设置

  • css.format.enable - 启用/禁用默认 CSS 格式化程序。
  • css.format.newlineBetweenRules - 用空行分隔规则集。
  • css.format.newlineBetweenSelectors - 用新行分隔选择器。
  • css.format.spaceAroundSelectorSeparator - 确保选择器分隔符 '>'、'+'、'~' 周围有一个空格字符(例如,a > b)。

lessscss 也存在相同的设置。

将 Sass 和 Less 转换为 CSS

VS Code 可以通过我们集成的任务运行器与 Sass 和 Less 转译器集成。我们可以使用它将 .scss.less 文件转译为 .css 文件。让我们逐步完成转译一个简单的 Sass/Less 文件。

步骤 1:安装 Sass 或 Less 转译器

在本演练中,让我们使用 sassless Node.js 模块。

注意: 如果您尚未安装Node.jsnpm 包管理器,您需要为本演练安装它们。为您的平台安装 Node.js。Node 包管理器 (npm) 包含在 Node.js 发行版中。您需要打开一个新的终端(命令提示符)才能将 npm 添加到您的 PATH 中。

npm install -g sass less

步骤 2:创建一个简单的 Sass 或 Less 文件

在空文件夹中打开 VS Code 并创建一个 styles.scssstyles.less 文件。将以下代码放入该文件中

$padding: 6px;

nav {
  ul {
    margin: 0;
    padding: $padding;
    list-style: none;
  }

  li { display: inline-block; }

  a {
    display: block;
    padding: $padding 12px;
    text-decoration: none;
  }
}

对于上述文件的 Less 版本,只需将 $padding 更改为 @padding

注意: 这是一个非常简单的示例,这就是为什么两种文件类型之间的源代码几乎相同的原因。在更高级的场景中,语法和结构将大不相同。

步骤 3:创建 tasks.json

下一步是设置任务配置。为此,请运行终端 > 配置任务,然后单击从模板创建 tasks.json 文件。在显示的选

这将在工作区的 .vscode 文件夹中创建一个示例 tasks.json 文件。该文件的初始版本包含一个运行任意命令的示例。我们将修改该配置以进行 Sass/Less 的转译。

// Sass configuration
{
  // See https://go.microsoft.com/fwlink/?LinkId=733558
  // for the documentation about the tasks.json format
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Sass Compile",
      "type": "shell",
      "command": "sass styles.scss styles.css",
      "group": "build"
    }
  ]
}
// Less configuration
{
  // See https://go.microsoft.com/fwlink/?LinkId=733558
  // for the documentation about the tasks.json format
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Less Compile",
      "type": "shell",
      "command": "lessc styles.less styles.css",
      "group": "build"
    }
  ]
}

步骤 4:运行构建任务

由于这是文件中唯一的命令,您可以通过按下 ⇧⌘B (Windows, Linux Ctrl+Shift+B)运行构建任务)来执行它。示例 Sass/Less 文件应该没有任何编译问题,因此运行该任务所做的只是创建一个相应的 styles.css 文件。

由于在更复杂的环境中可能有多个构建任务,因此我们会在按下 ⇧⌘B (Windows, Linux Ctrl+Shift+B)运行构建任务)后提示您选择要执行的任务。此外,我们允许您扫描输出以查找编译问题(错误和警告)。根据编译器,在列表中选择适当的条目以扫描工具输出中的错误和警告。如果您不想扫描输出,请从显示的列表中选择从不扫描构建输出

此时,您应该在文件列表中看到一个额外的文件 styles.css

如果您想将该任务设置为默认构建任务,请从全局终端菜单中执行配置默认构建任务,然后从显示的列表中选择相应的 SassLess 任务。

注意:如果您的构建失败或看到诸如“编译目录时必须指定输出目录”之类的错误消息,请确保您的 tasks.json 中的文件名与磁盘上的文件名匹配。您始终可以通过从命令行运行 sass styles.scss styles.css 来测试您的构建。

自动化 Sass/Less 编译

让我们更进一步,使用 VS Code 自动化 Sass/Less 编译。我们可以使用与之前相同的任务运行器集成,但需要进行一些修改。

步骤 1:安装 Gulp 和一些插件

我们将使用 Gulp 来创建一个自动化 Sass/Less 编译的任务。我们还将使用 gulp-sass 插件来简化操作。Less 插件是 gulp-less

我们需要全局(-g 开关)和本地安装 gulp。

npm install -g gulp
npm install gulp gulp-sass gulp-less

注意: gulp-sassgulp-less 是我们之前使用的 sasslessc 模块的 Gulp 插件。您可以使用许多其他 Gulp Sass 和 Less 插件,以及 Grunt 插件。

您可以通过在终端中键入 gulp -v 来测试您的 gulp 安装是否成功。您应该看到全局 (CLI) 和本地安装都显示了版本。

步骤 2:创建一个简单的 Gulp 任务

在之前的同一文件夹中打开 VS Code(该文件夹包含 styles.scss/styles.less.vscode 文件夹下的 tasks.json),并在根目录创建 gulpfile.js

将以下代码放入 gulpfile.js 文件中

// Sass configuration
var gulp = require('gulp');
var sass = require('gulp-sass')(require('sass'));

gulp.task('sass', function(cb) {
  gulp
    .src('*.scss')
    .pipe(sass())
    .pipe(
      gulp.dest(function(f) {
        return f.base;
      })
    );
  cb();
});

gulp.task(
  'default',
  gulp.series('sass', function(cb) {
    gulp.watch('*.scss', gulp.series('sass'));
    cb();
  })
);
// Less configuration
var gulp = require('gulp');
var less = require('gulp-less');

gulp.task('less', function(cb) {
  gulp
    .src('*.less')
    .pipe(less())
    .pipe(
      gulp.dest(function(f) {
        return f.base;
      })
    );
  cb();
});

gulp.task(
  'default',
  gulp.series('less', function(cb) {
    gulp.watch('*.less', gulp.series('less'));
    cb();
  })
);

这里发生了什么?

  1. 我们的 default gulp 任务首先在启动时运行一次 sassless 任务。
  2. 然后,它会监视工作区根目录中任何 SCSS/Less 文件的更改,例如在 VS Code 中打开的当前文件夹。
  3. 它会获取已更改的 SCSS/Less 文件集,并通过我们各自的编译器运行它们,例如 gulp-sassgulp-less
  4. 我们现在有一组 CSS 文件,每个文件的命名都与其原始 SCSS/Less 文件相对应。然后,我们将这些文件放在同一目录中。

步骤 3:运行 gulp 默认任务

为了完成与 VS Code 的任务集成,我们需要修改之前的任务配置以运行我们刚刚创建的默认 Gulp 任务。您可以删除 tasks.json 文件或清空它,仅保留 "version": "2.0.0" 属性。现在从全局终端菜单执行运行任务。请注意,您会看到一个选择器,其中列出了 gulp 文件中定义的任务。选择 gulp: default 以启动任务。我们允许您扫描输出以查找编译问题。根据编译器,在列表中选择适当的条目以扫描工具输出中的错误和警告。如果您不想扫描输出,请从显示的列表中选择从不扫描构建输出。此时,如果您创建和/或修改 Less 或 SASS 文件,您会看到生成的相应 CSS 文件和/或在保存时反映的更改。您还可以启用自动保存,使事情更加简化。

如果您想将 gulp: default 任务设置为按下 ⇧⌘B (Windows, Linux Ctrl+Shift+B) 时执行的默认构建任务,请从全局终端菜单中运行 配置默认构建任务,然后从显示的列表中选择 gulp: default

步骤 4:终止 gulp 默认任务

gulp: default 任务在后台运行并监视 Sass/Less 文件的文件更改。如果您想停止该任务,可以使用全局终端菜单中的终止任务

自定义 CSS、SCSS 和 Less 设置

您可以将以下 lint 警告配置为用户和工作区设置

validate 设置允许您关闭内置验证。如果您更喜欢使用不同的 linter,您将这样做。

ID 描述 默认值
css.validate 启用或禁用所有 css 验证 true
less.validate 启用或禁用所有 less 验证 true
scss.validate 启用或禁用所有 scss 验证 true

要配置 CSS 的选项,请使用 css.lint. 作为 ID 的前缀;对于 SCSS 和 Less,请分别使用 scss.lint.less.lint.

如果您想启用 lint 检查,请将设置设置为 warningerror,使用 ignore 禁用它。Lint 检查在您键入时执行。

ID 描述 默认值
validate 启用或禁用所有验证 true
compatibleVendorPrefixes 使用带有特定供应商前缀的属性时(例如 -webkit-transition),请确保还包括所有其他供应商特定的属性,例如 -moz-transition-ms-transition-o-transition ignore
vendorPrefix 使用带有特定供应商前缀的属性时(例如 -webkit-transition),请确保还包括标准属性(如果存在),例如 transition warning
duplicateProperties 警告同一规则集中重复的属性 ignore
emptyRules 警告空的规则集 warning
importStatement 警告使用 import 语句,因为 import 语句是按顺序加载的,这对网页性能有负面影响 ignore
boxModel 使用 paddingborder 时不要使用 widthheight ignore
universalSelector 警告使用通用选择器 *,因为它已知速度很慢,应该避免使用 ignore
zeroUnits 警告使用带单位的零,例如 0em,因为零不需要单位。 ignore
fontFaceProperties 警告在没有定义 srcfont-family 属性的情况下使用 @font-face 规则 warning
hexColorLength 警告使用不包含三个或六个十六进制数字的十六进制数字 error
argumentsInColorFunction 警告颜色函数中参数数量无效,例如 rgb error
unknownProperties 警告使用未知的属性 warning
ieHack 警告使用 IE hack *propertyName_propertyName ignore
unknownVendorSpecificProperties 警告使用未知的供应商特定属性 ignore
propertyIgnoredDueToDisplay 警告使用由于显示而被忽略的属性。例如,使用 display: inlinewidthheightmargin-topmargin-bottomfloat 属性无效。 warning
important 警告使用 !important,因为它表示整个 CSS 的特异性已经失控,需要重构。 ignore
float 警告使用 float,因为浮动会导致脆弱的 CSS,如果布局的一个方面发生变化,很容易破坏。 ignore
idSelector 警告使用 id 选择器 #id,因为选择器不应包含 ID,因为这些规则与 HTML 过于紧密地耦合。 ignore

后续步骤

请继续阅读以了解

  • 配置任务 - 深入了解任务以帮助您将 SCSS 和 Less 转译为 CSS。
  • 基本编辑 - 了解强大的 VS Code 编辑器。
  • 代码导航 - 在您的源代码中快速移动。
  • HTML - CSS 只是开始,HTML 在 VS Code 中也得到了很好的支持。

常见问题

VS Code 是否提供颜色选择器?

是的,将鼠标悬停在 CSS 颜色引用上,将显示颜色选择器。

是否支持基于缩进的 Sass 语法 (.sass)?

否,但在 Marketplace 中有几个扩展支持缩进风格的 Sass,例如,最初由 Robin Bentley 创建的 Sass 扩展,现在由 Leonard Grosoli 维护。