vscode资源管理器目录缩进看起来挤成一团，是因为默认workbench.tree.indent值为8px，对多层嵌套项目（如laravel的app/http/controllers/api/v1/）层级区分不足；这不是bug，而是空间优先的设计取舍；需设workbench.tree.indent为16或20并启用workbench.tree.renderindentguides:true才能清晰显示层级关系。
为什么VSCode资源管理器目录缩进看起来挤成一团？
默认的 workbench.tree.indent 值是 8px，对现代多层嵌套项目（比如 Laravel 的 app/Http/Controllers/Api/V1/）来说，视觉层级几乎无法分辨。这不是 bug，而是设计取舍——空间优先 vs 清晰优先。
直接改配置最有效："workbench.tree.indent": 16 或 20 是多数团队验证过的舒适值。同时必须配 "workbench.tree.renderIndentGuides": true，否则光加缩进没连接线，反而更难定位父子关系。
- 改完不用重启，立即生效；但会影响所有树形视图（搜索结果、调试变量面板等）
- 如果用了 Remote-SSH，这个设置要写在远程机器的
settings.json里，本地设了无效 - 缩进超过 24px 容易导致侧边栏宽度不够，文件名被截断，得同步调宽资源管理器
Markdown 目录点不动？先查这三处硬性条件
不是插件装了就自动跳转。VSCode 的 Markdown 目录跳转依赖三个底层机制同时成立：标题有合法锚点、预览器启用 TOC、大纲视图能解析结构。
常见失效点：
-
markdown.preview.toc必须为true（仅影响预览窗口内的可点击目录） -
explorer.experimental.showOutline必须开启，否则侧边栏“大纲”面板压根不显示 - 标题文本里不能含空格或特殊符号（如
# 用户管理 & 权限控制），否则生成的锚点是#用户管理-&-权限控制，但点击时浏览器可能只识别前半段
验证方法：打开任意 .md 文件，按 Ctrl+Shift+P 输入 Developer: Toggle Developer Tools，在 Console 里输入 document.querySelector('h2').id，看输出是否和链接目标一致。
Material Icon Theme 图标不显示？别只盯着安装步骤
图标包失效，90% 情况下不是没装好，而是被显式配置覆盖了。最常踩的坑是 "workbench.iconTheme": null 或空字符串，这会强制禁用所有图标主题。
正确启用方式只有两种可靠路径：
- 用命令面板：
Ctrl+Shift+P→ 输入Preferences: File Icon Theme→ 选中目标主题（如material-icon-theme） - 手动编辑
settings.json，确保该字段值是字符串，比如"workbench.iconTheme": "material-icon-theme"，绝不能是null或""
额外注意：单文件模式（File > Open File）下图标主题通常不加载，必须用 File > Open Folder 才能触发完整资源管理器逻辑。
大型 Laravel 项目目录卡顿？排除比优化更重要
VSCode 卡，往往不是渲染慢，而是索引爆炸。vendor、node_modules、storage/logs 这些目录不加排除，Intelephense 和搜索功能就会反复扫描几十万文件。
关键配置写在工作区级 .vscode/settings.json 里才真正生效：
"files.exclude": { "**/vendor": true, "**/node_modules": true }"search.exclude": { "**/storage/logs/**": true, "**/public/build/**": true }- 别漏掉
"editor.largeFileOptimizations": false—— 对composer.lock这类大文本文件，关掉语法高亮反而更稳
这些排除规则不会影响 Git 或终端操作，只作用于 VSCode 内部索引。改完后右下角会提示“正在重新索引”，等状态消失再测性能，别急着关窗口。
真实项目里，目录视图的“清晰”和“响应快”从来不是单点优化能解决的。缩进、图标、排除、大纲，四者互相牵制——调大缩进却没开连接线，看着乱；开了大纲却不排除 vendor，查个定义要等三秒。每个开关背后都是权衡，而不是开关本身。
