vscode卡顿主因是files.watcherexclude未配或配错，导致inotify句柄耗尽、ctrl+p延迟、保存卡顿；须用"/node_modules/"等精确路径写入项目级.vscode/settings.json，并配合search.exclude和python.analysis.diagnosticmode协同优化。
files.watcherExclude 配置失效导致目录扫描卡死
VSCode 打开项目后资源管理器展开慢、Ctrl+P 延迟高、保存卡顿，90% 是 files.watcherExclude 没配或配错。它不控制搜索，而是从操作系统层阻止文件监视器（chokidar / inotify）监听指定路径——漏掉这一项，venv 或 node_modules 里几万个文件的变动会持续触发回调，直接拖垮主线程。
常见错误写法："node_modules"、"**/node_modules/"、"**\venv\**"（反斜杠）、"venv/**"（缺开头 **/）——这些全不匹配，VSCode 静默忽略整条规则。
-
"**/venv/**"✅ 同时排除venv及其所有子目录（如venv/lib/python3.11/site-packages/...） -
"**/__pycache__/**"✅ 排除所有层级的缓存目录，避免.pyc文件反复触发事件 -
"**/dist/**"✅ 构建产物目录必须排除，否则 Linux 下容易触发ENOSPC（inotify limit reached） - 必须写在项目根目录的
.vscode/settings.json中，用户级设置对多根工作区无效
search.exclude 和 files.exclude 不是同一回事
files.exclude 只影响左侧资源管理器是否显示文件夹，对 Ctrl+Shift+F 全局搜索完全没用；search.exclude 才真正跳过搜索时的 I/O 读取。但只配它还不够——如果 files.watcherExclude 没关，搜索前的“准备阶段”就已被监听风暴卡住。
-
search.exclude的路径写法更宽松："**/venv"和"**/venv/**"效果一致，但建议统一用后者避免歧义 -
files.exclude可以加"**/.git"让资源管理器清爽，但它不影响搜索性能 - 改完三者任意一项都必须执行
workbench.action.reloadWindow（Ctrl+Shift+P 输入后回车），仅关闭再打开窗口不重载 watcher 状态 - 临时验证：打开搜索面板 → 点右上角 ⋯ → «Files to exclude» → 填
**/venv/**,**/dist/**（英文逗号分隔，无空格），本次搜索立即生效
Pylance 和 GitLens 会绕过 exclude 规则
即使 search.exclude 和 files.watcherExclude 都配齐，Pylance 仍可能扫描 venv 里的第三方包做类型推导，GitLens 也会主动读取未提交文件甚至 venv 内容来渲染 blame 信息——它们不走 VSCode 的标准排除链路。
- 限制 Pylance 范围：
"python.analysis.diagnosticMode": "workspace"（只分析工作区，不进venv） - 禁用自动导入提示：
"python.suggest.autoImports": false，避免反复解析包路径 - GitLens 在大型项目中建议工作区禁用，或设
"gitlens.advanced.fileWatcher.latency": 1000 - 绝对不要信“插件有用就开着”，
Auto Rename Tag、Path Intellisense这类插件会在后台持续递归遍历整个文件树
Linux/macOS 下 inotify 句柄耗尽是硬伤
即使所有 exclude 都写对，系统级 inotify 限制太低也会让 VSCode fallback 到低效轮询模式。现象是：展开文件夹延迟明显、热更新响应变慢、files.watcherExclude 似乎“失效”。
- 检查当前限制：
cat /proc/sys/fs/inotify/max_user_watches，默认常为 8192，中型 Python 项目就超限 - 临时提升：
sudo sysctl fs.inotify.max_user_watches=524288 - 永久生效（需 root）：
echo 'fs.inotify.max_user_watches=524288' | sudo tee -a /etc/sysctl.conf && sudo sysctl -p - 注意：该值不是越大越好，过高可能挤占内核内存；524288 对大多数 Django/Flask 项目已足够
files.watcherExclude 断源头、search.exclude 控搜索、python.analysis.diagnosticMode 压语言服务，少一个环节，CPU 就可能持续飙到 90%。
