🚀 在 VS Code 中

CSS、SCSS 和 Less

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

提示: 点击上面的扩展磁贴以阅读描述和评论,从而决定哪个扩展最适合您。请在市场中查看更多信息。

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 代码片段

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

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

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

语法验证和 Linting

支持 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 属性、at-directives、伪类和伪元素的理解。然后,VS Code 将为提供的属性、at-directives、伪类和伪元素提供语言支持,例如完成和悬停信息。

您可以在 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.lesstasks.json,位于 .vscode 文件夹下),并在根目录中创建 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. 然后,它监视对我们工作区根目录(例如,VS Code 中当前打开的文件夹)中任何 SCSS/Less 文件的更改。
  3. 它获取已更改的 SCSS/Less 文件集,并通过我们各自的编译器(例如 gulp-sassgulp-less)运行它们。
  4. 现在我们有了一组 CSS 文件,每个文件都分别以其原始 SCSS/Less 文件命名。然后我们将这些文件放在同一目录中。

步骤 3:运行 gulp default 任务

为了完成与 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 default 任务

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 警告使用 @font-face 规则而不定义 srcfont-family 属性 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 只是开始,VS Code 也非常好地支持 HTML。

常见问题

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

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

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

否,但是市场中有很多扩展支持 Sass 的缩进风格,例如,最初由 Robin Bentley 创建,现在由 Leonard Grosoli 维护的 Sass 扩展。