vscode路径替换需手动控制范围并验证，因其仅做纯文本匹配而非语义感知；应使用正则限定在import/export/require行、排除注释与字符串、分批次处理别名，并运行tsc、检查diff、重启ts server验证。
VSCode 无法直接“语义感知”地替换文件路径——它只做纯文本匹配，所以 import { foo } from './utils' 和 require('./utils') 中的 ./utils 是能被搜到的，但 ./utils.ts 改成 ./lib/utils 后，import 语句里的引号内容、相对路径计算、甚至别名映射（如 @/）全得靠你手动控制范围和验证。
为什么直接搜 ./old/path 常常漏掉或误伤
常见错误现象：替换了 80% 的导入路径，但 src/pages/Home.tsx 里那行 import Comp from '../components/Button' 没动；或者把注释里写的 // see ./old/path/README.md 也一起改了。
- VSCode 默认排除
node_modules、dist、.git等目录，如果旧路径在dist/生成的声明文件里，它根本不会扫 - 大小写开关（
Aa）开着时，./Old/Path不会匹配./old/path - 没开“全字匹配”（
ab）或正则\b边界，./old/path可能命中./old/pathname或my-old/path - 路径中含特殊字符（如
.、/、-）却没启用正则模式，.会被当通配符，/在 glob 中有含义，容易误判
限定范围：只在 import/export/require 行里搜
使用正则表达式 + 上下文约束，比盲目扫所有文件安全得多。例如要改 ./api/client → ./lib/api/client：
- 打开替换面板：
Ctrl+Shift+H（Windows/Linux）或Cmd+Shift+H（macOS） - 开启正则模式（点击
.*图标） - 搜索框填：
from\s+['"]\./api/client['"]或require\s*\(?\s*['"]\./api/client['"] - 替换框填：
from './lib/api/client'（注意引号类型保持一致） - “包含文件”框填：
**/*.ts, **/*.js, **/*.tsx, **/*.jsx（逗号后不加空格）
这样只命中真正的模块导入语句，跳过注释、字符串拼接、JSON 配置等干扰项。
处理别名路径（如 @/、~/）要另起一次搜索
VSCode 不知道你的 tsconfig.json 里 "baseUrl": "./src" 或 Webpack 的 resolve.alias 是什么，所以 @/api 和 ./src/api 是两套独立路径，必须分开处理：
- 先搜
from\s+['"]@/api→ 替换为from '@/lib/api' - 再搜
from\s+['"]\./src/api→ 替换为from './src/lib/api'（注意斜杠方向和前缀） - 如果项目用
~别名，确认构建工具是否识别它；否则 VSCode 搜不到，得先统一改成标准相对路径再重构 - 别名导入的命名空间（如
import { foo } from '@/'）不能靠路径替换解决，需配合 ESLint 规则或tsc --noEmit验证导出是否还存在
替换后必须验证的三件事
路径改完不等于能跑，尤其 TypeScript 项目：
- 运行
tsc --noEmit，看是否有Cannot find module报错——这是最硬的反馈 - 用
git diff快速扫一遍变更，重点检查import行、export行、require行是否都改对了，有没有多出空格或引号不匹配 - 启动开发服务器，点开几个关键页面，确认组件、API 调用、样式加载都没 404——路径错一个字符，浏览器 Network 标签就亮红灯
最容易被忽略的是：路径替换后，TypeScript 的自动导入补全（Ctrl+Space）可能还在推旧路径，此时要清空 TS Server 缓存（Ctrl+Shift+P → Restart TS Server），否则你会在新文件里继续手敲错路径。
