VSCode中“只替换当前项目”指限定在当前打开的文件夹（工作区根目录）内搜索替换，需手动设置搜索路径、排除无关目录，并关闭全局匹配和符号链接跟随以避免误操作。
VSCode 中“只替换当前项目”实际指什么
VSCode 本身没有“项目级作用域”的内置概念，所谓“当前项目”通常指你打开的文件夹（即工作区根目录）。它不会自动识别 package.json、pyproject.toml 或其他项目配置来限定范围——你得靠路径过滤和搜索范围控制来实现“仅本项目”。否则，Ctrl+Shift+H（全局替换）可能误触已打开但不属于该项目的其他文件标签，或 VSCode 缓存中的旧文件。
用文件夹路径精准限定搜索范围
最可靠的方式是主动指定搜索入口：在搜索面板顶部的“文件夹”输入框中填入相对路径（支持 glob），让 VSCode 只扫描该路径下的内容。
- 如果项目根是
/home/user/my-app，且你已在 VSCode 中用“Open Folder”打开它，直接留空或填./即可——但注意：留空时若同时打开了多个文件夹，VSCode 会搜全部根；务必确认左下角显示的是你想要的文件夹 - 想排除
node_modules和dist？在“文件排除”框里填：**/node_modules/**,**/dist/** - 只想改
src/下的 JS 文件？在“文件名包含”框填：*.js，再在“文件夹”框填：src - 路径区分大小写：Linux/macOS 下
Src≠src；Windows 默认不敏感，但用 WSL 或远程开发时需留意
避免被“已打开文件”干扰替换范围
VSCode 默认开启 search.useGlobalWordMatches，且搜索会包含所有已打开但未保存的编辑器标签——哪怕它们物理路径不在当前文件夹内。这常导致误替换。
- 关闭干扰项：在设置中搜索
search.exclude，确保没意外包含外部路径；更关键的是关掉search.followSymlinks（防止跳到项目外的符号链接目录） - 手动清理：按
Ctrl+K Ctrl+W关闭所有未保存的外部文件标签，或右键编辑器标签 → “Close All Other Editors” - 验证范围：执行搜索前，先点搜索框右上角的
…→ “Toggle Search Details”，查看底部显示的“Searching in X folders”是否符合预期
批量替换时确认每处修改的上下文
即使范围设对了，正则或大小写敏感选项不对，仍可能批量改错。特别是涉及 import 路径、变量名、JSON key 等场景。
- 开启
Match Case（Aa按钮）：避免把User替成Admin的同时误改user字段 - 开启
Whole Word（\b按钮）：防止把count替换进account - 慎用正则：如要替换
console.log为debug，写console\.log而非console.log（点号需转义） - 别跳过预览：点击
Replace All前，先点左侧箭头展开所有匹配项，逐个看上下文——VSCode 不提供 diff 预览，但折叠/展开行能快速判断是否安全
真正卡住人的往往不是功能找不到，而是“以为在项目里操作”，结果替换了另一个同名但路径不同的 config.js；或者依赖了未刷新的文件缓存，导致搜索结果漏掉刚新建的目录。动手前花十秒确认左下角工作区路径和搜索详情里的实际扫描路径，比事后 git checkout 回退快得多。
