VS Code 怎样只关闭 CSS 文件中的颜色预览方块
来源:17golang原创
时间:2026-11-16 20:12:36 100浏览 收藏
只关闭 CSS 文件里色值旁的小方块,可以在 VS Code 的语言专属设置 [css] 中加入 "editor.colorDecorators": false。把它放在 CSS 块内,而不是直接写在设置根级,才能把这项改动限定到 CSS。其他语言仍按各自原来的配置显示颜色预览。
官方地址:https://code.visualstudio.com/
颜色方块是编辑辅助功能,便于预览颜色和打开颜色选择器。隐藏它不会改写 CSS 色值,也不需要删除样式、切换主题或关闭 CSS 语言支持。下面以已经打开的单文件夹项目为例,只调整当前工作区;若要在所有项目中使用同样偏好,可以把相同语言块放入当前配置文件的用户设置。
1. 确认文件语言并打开工作区设置
在左侧资源管理器中打开一个普通的 styles.css 文件,先看右下角状态栏的语言模式是否为 CSS。语言专属设置根据编辑器识别的语言应用,不是只看文件名字。若状态栏显示 Plain Text,点击该标签,在语言列表选择 CSS,再继续操作。
按 Ctrl+Shift+P(macOS 为 Command+Shift+P)打开命令面板,输入并选择 Preferences: Open Workspace Settings (JSON)。中文界面可搜索“打开工作区设置”,注意选择带 JSON 的工作区项,而不是默认设置的只读参考文件。

单文件夹工作区通常会打开项目中的 .vscode/settings.json。此时确认标签页是设置文件,左侧路径属于当前项目,就找到了本次要改的位置。如果尚未打开文件夹,先通过“文件 → 打开文件夹”进入项目;不要误把一份普通业务 JSON 当成编辑器设置。
如果打开的是多根工作区,工作区设置保存在 .code-workspace 文件的 settings 对象内,而单个根文件夹还可以拥有自己的设置。本文的完整最小示例针对单文件夹的 .vscode/settings.json;多根工作区请把语言块合并进相应的设置对象。
2. 在 CSS 专属块里关闭颜色装饰
若设置文件目前为空对象,把它改成下面的内容。已有其他设置时,只合并 [css] 成员;原来已经有这个成员,就在同一对象内新增或修改 editor.colorDecorators,避免写出两个同名的 CSS 块。
{
"[css]": {
"editor.colorDecorators": false
}
}
[css] 是语言覆盖的键,false 是布尔值,不加引号。这个开关控制颜色装饰与相关颜色选择器的编辑器呈现。示例使用有效 JSON,因此没有放入注释;字段含义已在这里说明。不要把该片段整段追加到已有根对象后面,设置文件只能有一个根对象。

例如你原先设置了缩进宽度,可以这样保留它,并在同一根对象里加入 CSS 覆盖:
{
"editor.tabSize": 2,
"[css]": {
"editor.colorDecorators": false
}
}
这里的 editor.tabSize 只是演示如何保留已有设置,不是完成目标所必需的新选项。若原来的值不同,保留自己的值即可。对象成员之间用逗号分隔;如果出现红色语法标记,先修正缺少的逗号或大括号,再保存。
通过“文件 → 保存”或 Ctrl+S / Command+S 保存。标签页上的未保存标记消失,意味着编辑内容已经写入文件。正常应用编辑器设置不需要重装 VS Code,也不需要给 CSS 项目安装依赖。
3. 回到样式文件确认效果并排查覆盖
点击 styles.css 标签,找到原来带色块的色值。预期变化是:颜色小方块消失,#2f7d68 等文字保留,选择器和属性仍有语法高亮。如果需要一个简单对照,可以在练习样式文件中使用下面的原创建议样例,无需运行应用。
/* 用固定色值观察编辑器装饰,不改变已有页面业务样式 */
.preview-tag {
color: #2f7d68;
background-color: #f1e8d7;
}
再打开一个原本可以显示色块的 SCSS 文件。只改 [css] 不会给它设置相同的关闭覆盖;它应继续遵循原来的 SCSS 或通用配置。这个对照的前提是 SCSS 原先允许颜色装饰。如果原先就关闭了它,本次操作不会自动替你打开。

如果 CSS 色块仍在,按下面顺序看当前设置:先确认活动文件右下角仍是 CSS;再确认保存的是当前工作区配置;然后在设置编辑器中用 @lang:css @id:editor.colorDecorators 搜索相关项,查看用户、工作区以及可用的文件夹作用域是否有冲突。处在远程窗口或切换了配置文件时,也要确认自己修改的是当前环境实际使用的设置。
语言专属设置优先于非语言专属设置;同一语言、同一设置在不同作用域重复定义时,还需要看相应作用域的覆盖关系。因此,“我在全局写了 false”并不代表语言专属 true 一定会被覆盖。排查时比较同一个键所在的对象与作用域,比反复开关通用选项更直接。
| 写法或动作 | 作用范围 | 适合情况 |
|---|---|---|
| 工作区 [css] 内设 false | 当前工作区的 CSS | 只在一个项目隐藏 |
| 用户 [css] 内设 false | 当前用户配置下的 CSS,仍受覆盖关系影响 | 把它作为个人偏好 |
| 根级设 false | 通用编辑器配置,可能被语言覆盖 | 目标已不是只调整 CSS |
| 删除本次新增的 CSS 键 | 恢复从其他配置继承 | 撤销本次调整 |
如果原来就有 editor.colorDecorators,回退时恢复记录下来的旧值;如果本次才新增,删除这个成员即可,别把同一 CSS 块内的格式化等其他偏好一起删掉。删除覆盖后是否重新出现色块,取决于继承到的有效值。
SCSS 和 Less 为什么没有一起关闭?
它们分别使用 scss 和 less 语言标识。本教程只调整 css;若另有需要,可以分别增加 [scss] 或 [less] 覆盖,不要把“CSS 相关语言”理解成一个自动联动的开关。
网页上的颜色会跟着变吗?
不会。这项设置只改变编辑时的装饰。没有修改样式文件里的声明,就不会因为关闭预览方块而让页面色值改变。
关闭之后还能点击小方块选色吗?
被隐藏的内联颜色方块不能再作为点击入口。如果常用内置颜色选择器,适合保留预览,或者在需要选色时恢复该设置,而不是同时期待隐藏入口又保持相同的点击操作。
官方参考:https://code.visualstudio.com/docs/languages/css;https://code.visualstudio.com/docs/configure/settings。前者说明颜色预览开关,后者说明语言设置与作用域覆盖。
-
275 收藏
-
427 收藏
-
219 收藏
-
116 收藏
-
405 收藏
-
322 收藏
-
332 收藏
-
127 收藏
-
296 收藏
-
文章 · 软件教程 | 38分钟前 | 开发环境 · vs code · VS Code uid GID devcontainer.json Dev Containers remoteUser containerUser258 收藏
-
152 收藏
-
368 收藏
-
文章 · 软件教程 | 45分钟前 | 开发工具 · vs code · 软件教程 · VS Code settings.json Workspace settings Settings editor 设置优先级327 收藏
-
211 收藏
-
117 收藏
-
338 收藏
-
228 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习