VSCode大规模工程索引中断主因是inotify句柄超限或内存溢出导致tsserver/rg.exe反复崩溃，需同步调高max_user_watches、配置files.watcherExclude与search.exclude、禁用符号链接搜索并处理编码与企业拦截问题。
VSCode 在大规模工程中索引中断，根本不是“慢”，而是监听器注册失败或内存被撑爆后主动退出——tsserver 崩、rg.exe 卡、状态栏长期卡在 Indexing… 12/842，都是表象，背后是系统资源或配置没对齐。
为什么 tsserver 和 rg.exe 会反复重启
Linux/macOS 下，tsserver 和文件监听器共用 inotify 句柄；Windows 上 NTFS 监听事件队列有硬上限。一旦项目里有 node_modules、.git、dist 这类目录没排除，VSCode 就会为每个文件注册监听——句柄数超限后，进程直接被系统 kill，然后自动拉起，形成“崩溃→重启→再崩溃”循环。
-
cat /proc/sys/fs/inotify/max_user_watches小于524288必须调高，否则连 monorepo 的packages/*/node_modules都撑不住 -
ps aux | grep tsserver若看到进程 PID 频繁变化，基本可确认是监听器崩了 - Remote-SSH 场景下，
VSCODE_NODE_OPTIONS="--max-old-space-size=2048"必须设在remote.SSH.remoteServerEnv，本地设置无效
files.watcherExclude 和 search.exclude 必须成对配
只配 search.exclude 是治标不治本：它能跳过搜索结果，但监听器照样注册、内存照样吃、索引照样卡死。真正要防中断，得先让 VSCode 别去“看”那些目录。
-
files.watcherExclude控制监听范围，必须包含："**/node_modules/**"、"**/.git/**"、"**/target/**"、"**/.next/**"、"**/*.log" -
search.exclude控制搜索范围，可稍宽松，但结尾的/**不能省——"**/node_modules"会误匹配src/my_node_modules，只有"**/node_modules/**"才安全 - 如果项目用了
.gitignore，建议把非空行全转成files.watcherExclude条目，避免 GitLens 等插件重复扫描同一堆路径
中文路径和编码会让索引更脆弱
中文文件名本身不卡，但 VSCode 在解析含中文路径的文件时，若底层文件系统（如某些 ext4 挂载选项）返回非 UTF-8 字节序列，就会触发额外解码尝试，CPU 占用飙升；更常见的是文件内容编码不是 UTF-8，导致 rg.exe 静默跳过整份文件——你看到文件在侧边栏，但它压根没进索引。
- 右下角点击编码（如显示
GBK），选Reopen with Encoding→UTF-8；确认中文正常显示后再点Save with Encoding - 批量转换可用：
iconv -f GBK -t UTF-8 src/file.js > src/file.utf8.js，务必先备份 - 工作区统一预防：在
.vscode/settings.json加"files.encoding": "utf8"，但团队需同步该约定，否则 Git diff 会乱
企业环境里 rg.exe 被拦截是静默杀手
绿盾、北信源、明朝万达这类加密软件，默认阻止未打开文件的后台读取。现象是：文件双击打开后能搜到内容，关掉就搜不到——rg.exe 根本拿不到磁盘数据，返回空结果，VSCode 也无报错。
- 用 Everything 搜
rg.exe，路径通常在：resources/app/out/vs/workbench/contrib/search/browser/rg.exe - 将该完整路径加进加密软件白名单，策略需“立即生效”，不是仅重启 VSCode
- 临时验证：命令行运行
code --disable-extensions，若搜索恢复，说明某扩展（如 Vim 模拟器、GitLens）与加密策略冲突
真正难处理的不是“怎么配”，而是配完要不要 reload window、要不要删 .vscode/.search、要不要清 workspaceStorage——这些动作之间有依赖顺序，错一步索引就继续卡在旧状态。动手前先看状态栏是否还在动，不动了再清理，不然白忙。
