vscode大型项目卡顿主因是配置不当与扩展滥用：需在工作区settings.json中配全files.watcherexclude（如"/node_modules/"）、search.exclude，并禁用auto rename tag等高开销扩展，重启工作区生效。
VSCode 打开大型项目卡顿，90% 以上不是机器不行，而是默认配置在监听、索引、扩展加载上“没刹车”——files.watcherExclude 没配全、search.exclude 写错、扩展一启动就全量扫描，三者任一缺失都会让 CPU 持续飙高、Ctrl+P 延迟、保存变卡。
files.watcherExclude 配不全，inotify 就会耗尽
Linux/macOS 下 VSCode 用 inotify 监听文件变化，未排除 dist、build、.next 这类目录时，几万个构建产物文件一变动，就会触发回调风暴，直接卡死主线程。常见报错：ENOSPC 或 watcher limit reached。
-
files.watcherExclude必须写在工作区根目录的.vscode/settings.json中，用户级设置对大型项目无效 - 路径必须以
**/开头，例如"**/node_modules/**": true，写成"node_modules/**"或"node_modules"都不生效 - 至少加上：
"**/node_modules/**"、"**/dist/**"、"**/build/**"、"**/.git/**"、"**/logs/**"、"**/__pycache__/**" - 改完后必须关闭整个工作区再重新打开，仅重载窗口（
workbench.action.reloadWindow）不生效
search.exclude 和 files.watcherExclude 必须配齐
search.exclude 控制全局搜索（Ctrl+Shift+F）范围，files.exclude 只影响左侧资源管理器是否显示——很多人误以为加了 "node_modules": true 到 files.exclude 就能跳过搜索，结果搜出来一堆 venv/site-packages/ 下的文件，这不是 bug，是配错了地方。
-
search.exclude支持"**/node_modules"或"**/node_modules/**"，效果一致；建议统一用后者避免歧义 - Python 项目务必同步加：
"**/venv/**"、"**/.mypy_cache/**"；前端加："**/out/**"、"**/coverage/**" - 多根工作区下，每个子文件夹的
search.exclude是独立生效的，不能靠根目录一条规则覆盖全部 - 搜索面板右上角的 “files to exclude” 输入框会临时覆盖
search.exclude，适合一次性跳过某个临时目录
哪些扩展必须禁用或降级
扩展是性能杀手，尤其那些默认全量扫描项目的插件。实测数据显示，48% 的卡顿来自扩展，但盲目禁用会误伤刚需——得用内置工具定位真凶。
- 打开命令面板（
Ctrl+Shift+P），执行Developer: Open Process Explorer，观察Extension Host进程的内存与 CPU 占用，排序看前 3 名 - 再执行
Developer: Show Running Extensions，重点关注Activation Events含*或onStartup的扩展——这类一启动就常驻，不是按需加载 - 立即禁用：
Auto Rename Tag、Path Intellisense、Bracket Pair Colorizer（它们持续递归读取文件树） - 可降级使用：
GitLens设为"gitlens.advanced.fileWatcher.latency": 1000；ESLint关掉autoFixOnSave，改用命令手动触发
Pylance / TypeScript 语言服务必须“瘦身”
Python 项目里 Pylance 默认扫全工作区，遇到 venv 里的第三方包，会尝试解析所有类型定义；TS 项目中 tsserver 默认也全量加载 node_modules/@types，这是 CPU 卡顿主因之一。
- Python：在项目级
.vscode/settings.json中设"python.defaultInterpreterPath"指向本地 venv 解释器，并加"python.analysis.diagnosticMode": "workspace" - TypeScript：限制分析范围，加
"typescript.preferences.includeOnly": ["src/**/*"]或明确"include"路径，避免tsserver扫node_modules - 强制 TS 服务高优：
"extensions.experimental.affinity": { "ms-vscode.vscode-typescript-next": 2 }，避免被其他扩展抢占资源 - 大项目可考虑关掉自动类型获取：
"typescript.suggestionActions.enabled": false，补全延迟明显下降
真正容易被忽略的点是：某些插件（比如 GitLens、ESLint 插件）会绕过 files.watcherExclude 自行扫描，所以禁用非必要扩展比死磕配置更有效；另外，files.watcherExclude 不支持 ! 取反语法，无法“排除所有但保留某一个”，别在这上面浪费时间。
