真正的多根工作区需满足：窗口右下角显示workspace、状态栏有多个文件夹图标、通过add folder to workspace添加目录、保存为.code-workspace文件且json中folders含多个path。
多根工作区本身不提供“跨根目录搜索”功能，VSCode 的全局搜索（Ctrl+Shift+F）默认只在当前活动工作区（单根或已加载的多根）内生效；若你没真正创建多根工作区，所谓“跨库搜索”根本不会发生。
怎么确认自己用的是真正的多根工作区
VSCode 窗口右下角必须显示 Workspace（不是 Folder），且状态栏路径旁有多个文件夹图标——这是唯一可信的识别方式。误把多个文件夹拖进单根窗口、或用 File → Open Folder 打开任意一个子目录，都会导致搜索仅限该目录，其他“库”完全不可见。
- 启动 VSCode 后保持空窗口，再按
Ctrl+Shift+P→ 输入Add Folder to Workspace添加第一个目录 - 重复添加第二个、第三个……确保每个都通过同一入口加入，而非单独打开
- 务必执行
File → Save Workspace As，生成.code-workspace文件，否则关闭即丢失 - 检查
.code-workspace内容：应为 JSON 格式，folders字段包含多个path条目，不能是空数组或单条路径
为什么 Ctrl+Shift+F 搜不到另一个根下的文件
常见原因不是搜索功能失效，而是当前编辑器焦点所在的文件不属于你想搜的那个根——VSCode 的全局搜索范围由工作区定义，但“可读性”受文件系统权限和 VSCode 自身索引机制影响。如果某根目录被排除、未完成首次扫描、或路径含中文/空格未正确转义，结果就为空。
- 打开命令面板
Ctrl+Shift+P→ 运行Developer: Toggle Developer Tools，看 Console 是否报ENOTDIR或EACCES - 检查该根目录是否在
search.exclude或files.exclude中被意外写死（比如"**/backend": true误匹配了同名子目录） - 终端里手动
ls -la验证该路径是否存在且可读；若路径含空格，VSCode 有时会静默跳过，建议改用短横线命名 - 多根工作区首次加载后，需等待右下角状态栏从
Indexing...变为就绪，否则搜索可能漏掉新加入的根
替换时部分文件没被修改，大概率是路径过滤惹的祸
VSCode 替换操作严格遵循搜索时的 files to include 和 files to exclude 规则，且这些规则优先级高于工作区结构。即使两个根都已加载，若你在搜索面板里填了 src/**/*.ts，那另一个根里的 lib/index.js 就不会参与替换——它压根没进搜索结果集。
- 执行替换前，点搜索面板右上角
⋯→Preview Replace，逐个确认目标文件是否出现在预览列表中 - 避免在
files to include里用模糊通配符如**/api/**，它会匹配所有含api的路径，包括node_modules/@types/api，而后者通常被search.exclude屏蔽，造成行为不一致 - 若需跨根精确替换，建议先在资源管理器中分别右键每个根目录 →
Find in Folder，手动触发独立搜索，再分别替换 - 正则替换时注意捕获组引用：用
$1，不是\1；若启用.*模式却忘了关，普通字符串会被当正则解析，导致.、*等字符失焦
多根工作区的搜索边界是明确的，但它的“透明性”极低——没有视觉提示告诉你某个文件是否已被纳入索引，也没有实时日志说明哪一行被跳过。最稳妥的做法永远是：先右键目标根目录做 Find in Folder，再基于结果决定是否扩大范围。别依赖“应该能搜到”的直觉。
