必须安装图标主题扩展(如Material Icon Theme),VSCode自身无文件专属图标;安装后需手动启用,通过命令面板执行“Preferences: File Icon Theme”或在settings.json中添加"workbench.iconTheme": "material-icon-theme";.env等文件需配合"files.associations"与图标映射双重配置才能显示对应图标。

必须装图标主题扩展,VSCode 自身不带任何文件专属图标。
先装扩展再启用主题
图标不会自动出现,得靠第三方扩展提供图标配对逻辑。最常用的是 Material Icon Theme 和 vscode-icons,两者都支持大量语言和配置文件类型。
- 打开扩展面板(
Ctrl+Shift+X或Cmd+Shift+X),搜Material Icon Theme,安装由Equinusocio发布的版本 - 安装完后,按
Ctrl+Shift+P输入Preferences: File Icon Theme,选中它即可生效 - 也可以直接改
settings.json:加一行"workbench.iconTheme": "material-icon-theme" - 如果已装多个图标扩展,只启用一个,否则图标可能错乱或不显示
让 .env 显示齿轮图标要配两处
默认情况下 .env 就是普通文档图标,即使装了图标包也不变——因为扩展不知道该把它归为哪类文件。
- 先告诉 VSCode “这是配置文件”:
"files.associations": { "*.env": "dotenv" } - 再告诉图标包“给它画齿轮”:
"vsicons.associations.files": [{ "icon": "gear", "extensions": ["env"], "format": "svg" }] -
extensions里写["env"],不是[".env"];多写个点就完全不生效 -
icon名必须是扩展支持的,比如gear、config、settings都行,但dotenv不是合法 icon 名
为什么 .tsconfig.json 还是 JSON 图标
VSCode 默认把所有 .json 文件当通用 JSON 处理,vscode-icons 或 material-icon-theme 不会主动识别它是 TS 配置。
- 需要手动重分类:
"files.associations": { "*.tsconfig.json": "typescript" } - 再绑定图标:
"vsicons.associations.files": [{ "icon": "typescript-config", "extensions": ["tsconfig.json"], "format": "svg" }] -
extensions是精确匹配,不能写成["*.tsconfig.json"];后者只在files.associations里有效 - 两个配置缺一不可,只配图标映射,VSCode 还是把它当 JSON 解析,图标就不加载
最容易被忽略的是 files.associations 和图标映射的配合关系——前者决定语言模式,后者才决定图标渲染。改了文件名(比如 tsconfig.dev.json)却没同步更新这两处,图标就立刻回退到默认样式。


















