Ctrl+Shift+H全局替换路径易出错，因路径受文件系统、打包工具和IDE三重约束；须限定文件类型、排除dist/node_modules等目录、用正则精准匹配引号内路径，并替换后验证跳转与构建。
直接改路径字符串的全局替换，必须限定文件类型、排除生成目录、手动处理相对/绝对路径差异，否则极易破坏模块解析或构建产物。
为什么 Ctrl+Shift+H 替换路径常出错
路径不是普通文本——它受文件系统语义、打包工具解析逻辑、IDE 路径补全机制三重约束。常见失败现象包括：import 语句替换了但 TypeScript 报错、require('./src/utils') 变成 require('./lib/utils') 后运行时报 Cannot find module、替换后 Webpack 构建卡在 Module not found。
- 未排除
dist/、build/、node_modules/：这些目录下有大量已编译路径，替换后污染产物，且 Git 不会追踪，难以回滚 - 混淆相对路径与绝对路径：把
../components/Button错替成../lib/Button，但实际新路径是../../lib/Button - 忽略引号与括号包裹：搜索
./src会命中./src/index.ts，但也可能误中./src_test/或srcPath: './src'这类配置值 - 未处理不同分隔符：Windows 下路径用
\，而代码中几乎全是/；直接搜\src基本无效，且/在正则里需转义
files to include 和 files to exclude 必须手动填
VSCode 默认跳过很多目录，且 search.exclude 配置优先级高于 UI 输入框。不显式声明范围，等于随机搜索。
- 只改源码？填
**/*.ts、**/*.js、**/*.tsx、**/*.jsx（按项目实际加） - 还要改配置文件？额外加
webpack.config.js、vite.config.ts、tsconfig.json—— 但注意：tsconfig.json中的"baseUrl"和"paths"是别名根，不能和普通路径一起批量替 - 排除干扰项：在
files to exclude栏清空默认值，再手输!dist/**、!build/**、!node_modules/**（开头加!表示“不禁用”，即强制包含） - 千万别依赖 “取消勾选 Use Exclude Settings”：这个开关不稳定，尤其在多根工作区下常失效；显式写
!才真正可控
用正则模式精准匹配路径结构
纯字符串替换无法区分路径上下文。例如要把所有 ./src/ 改为 ./lib/，但要放过 ./src_test/ 和 srcPath: './src'。
- 安全写法（匹配 import/require 中的路径）：
from\s+['"](\./src\/[^'"]+)['"]→ 替换为from '$1'.replace('src', 'lib')，但 VSCode 不支持 JS 表达式替换，所以得拆成两步：先用正则捕获，再静态替换 - 更实用的捕获组替换：
from\s+['"](\./src\/)([^'"]+)['"]→from '$1'.replace('src', 'lib') + '$2'不行；正确是：from '$1$2'→from './lib/$2'（注意 $1 包含./src/，$2 是后续路径） - 匹配
require()：require\s*$$\s*['"](\./src\/[^'"]+)['"]\s*$$，替换为require('$1'.replace('src', 'lib'))同样不可行；应替换为require('./lib/$2')，其中 $2 是([^'"]+)捕获的内容 - 绝对路径别名（如
@/utils）不能用./src类方式处理，必须单独搜from\s+['"]@\/或require\s*$$\s*['"]@\/，并确认tsconfig.json的"paths"已同步更新
替换后必须验证的三个位置
路径修改不是“点一下全部替换就完事”。VSCode 不校验路径有效性，错误会在运行时爆发。
- 打开
Ctrl+Shift+G（Git 视图），看哪些文件被改了——重点检查import行、require行、new URL(..., import.meta.url)等动态路径 - 在终端执行
tsc --noEmit（TypeScript）或eslint .，确认无路径解析报错；若用 Vite，跑vite build --dry-run快速验证打包是否中断 - 打开一个被修改的文件，把光标停在新路径上，按
Ctrl+点击（Windows）看能否跳转——跳不到 = 路径错或别名没配，此时别急着提交
最易被忽略的是：路径替换后，ESLint 的 import/no-unresolved 规则或 TypeScript 的路径映射可能缓存旧状态，需要重启 TS Server（Ctrl+Shift+P → Typescript: Restart TS server）才生效。
