vscode全局搜索中文失效，主因是files to include为空或写错导致仅搜已打开文件；需清空该框验证，或用/,-/node_modules/*等glob语法精准控制范围，并确认search.include配置正确。
VSCode 全局搜索中文失效，大概率不是搜索功能坏了，而是文件压根没被纳入搜索范围——files to include 设置为空或写错时，VSCode 默认只搜当前打开的文件，不会遍历整个工作区。
为什么改了 files to include 还是搜不到中文？
全局搜索面板（Ctrl+Shift+F）下方的 files to include 输入框，控制的是“**哪些文件参与搜索**”，但它和 search.exclude 是两套独立逻辑：前者是白名单（只搜列出的），后者是黑名单（排除掉的）。如果 files to include 留空，VSCode 就退化为“仅搜索已打开的编辑器标签页”，哪怕你项目里全是 UTF-8 编码、中文满天飞，也搜不到未打开的文件。
- 留空 = 只搜当前打开的文件（哪怕只开了一个
README.md，其他所有 .ts/.js 都不查） - 填
**/*.ts= 只搜 .ts 文件，.js/.html 里的中文全被忽略 - 填
**/*.{ts,js,html,md}= 支持多后缀，但注意 VSCode 不支持正则语法，{}是 glob 扩展，需确认你的 VSCode 版本 ≥ 1.70（2026 年已全量支持） - Windows 用户若路径含中文，确保终端启动 VSCode 时未用
code .在缩略路径下执行（如C:\Users\张三\...\project→ 实际路径被截断，部分子目录无法索引）
files to include 和 search.exclude 冲突怎么办？
两者同时生效，且 files to include 优先级更高。比如你设了 files to include: **/*.js，又在 search.exclude 里写了 "**/utils/**": true，结果就是：只搜 utils/ 之外的 .js 文件；utils/index.js 即便存在，也不会被读取。
- 临时验证是否是包含规则问题：清空
files to include输入框，再搜一次中文 —— 如果立刻有结果，说明原设置过窄 - 想兼顾精准与覆盖：用
**/*开头，再排除干扰项，例如：**/*,-**/node_modules/**,-**/dist/**,-**/*.log（VSCode 支持-前缀表示排除，比search.exclude更局部、更可控） - 注意逗号分隔无空格：
**/*.ts,**/*.js✅，**/*.ts, **/*.js❌（空格会导致第二项失效） - 通配符
**必须出现在开头或斜杠后：src/**/*.ts有效，**/src/*.ts在某些旧版 remote-ssh 场景下可能漏匹配
中文路径文件被跳过？检查 files to include 是否隐式过滤
VSCode 对含中文路径的文件默认支持良好，但 files to include 若用了不兼容 glob 的写法，会直接跳过整层目录。典型表现是：能搜到 src/utils.ts 里的中文注释，但搜不到 src/工具函数/utils.ts 里的相同内容。
- 避免使用
*匹配中文字符：src/*/utils.ts不会匹配src/工具函数/utils.ts，因为*只匹配 ASCII 字母数字和下划线，不匹配 Unicode - 安全写法是放宽范围：
src/**/utils.ts或直接**/utils.ts，让**覆盖任意层级和字符集 - 远程开发（WSL / SSH）中，若服务端文件系统挂载点路径含中文（如
/mnt/c/Users/张三/project），需确认files to include路径与实际挂载路径一致 —— VSCode 不会自动做 Windows ↔ WSL 路径转换 - Git 子模块内路径若含中文，且未显式加入
files to include，默认不索引（search.useIgnoreFiles设为false也无效，子模块需单独声明）
真正容易被忽略的点是：files to include 是会话级临时设置，每次打开新搜索面板都会重置为空。你以为上次填过就一直生效，其实每次都要手动补上，或者干脆写进 .vscode/settings.json 用 search.include 固化 —— 但注意这个配置项名是 search.include，不是 files.include，拼错就完全不生效。
