如何通过命令行修改TypeScript文件移动后的关联导入路径？

方案一：AST工具精准修改（推荐大型项目） #

用jscodeshift（可通过npm安装）编写转换脚本，它会解析TypeScript的抽象语法树，精准定位导入语句并修改路径，避免正则替换的误匹配问题。

1. 安装依赖：

npm install -g jscodeshift @typescript-eslint/parser @typescript-eslint/eslint-plugin

2. 编写转换脚本（示例：update-imports.js）：

module.exports = function(fileInfo, api) {
  const j = api.jscodeshift;
  const root = j(fileInfo.source);

  // 配置原文件和新文件的路径（不含后缀的相对路径）
  const oldImportPath = './src/utils/old-dir/helper';
  const newImportPath = './src/utils/new-dir/helper';

  // 匹配所有导入该文件的语句，处理带.ts后缀和不带的情况
  root.find(j.ImportDeclaration)
    .filter(path => {
      const source = path.node.source.value;
      return source === oldImportPath || source === `${oldImportPath}.ts`;
    })
    .forEach(path => {
      path.node.source.value = newImportPath;
    });

  return root.toSource();
};

3. 执行脚本遍历项目TS/TSX文件：

jscodeshift -t update-imports.js ./src/**/*.{ts,tsx}

4. 移动目标文件：

mv ./src/utils/old-dir/helper.ts ./src/utils/new-dir/helper.ts

如果涉及多文件或动态相对路径，可在脚本中通过fileInfo.path获取当前处理文件的路径，结合新旧文件的绝对路径自动计算正确的相对导入路径。

方案二：Shell脚本结合正则替换（适合简单场景） #

如果项目导入路径格式统一，可快速用mv+sed批量替换，但要注意避免误改字符串内容：

1. 先移动文件：

mv ./src/old/location/utils.ts ./src/new/location/utils.ts

2. 批量替换关联导入路径：

# Linux环境
grep -rl "../old/location/utils" ./src --include="*.ts" --include="*.tsx" | xargs sed -i 's/\.\.\/old\/location\/utils/\.\.\/new\/location\/utils/g'

# Mac环境（sed参数有差异）
grep -rl "../old/location/utils" ./src --include="*.ts" --include="*.tsx" | xargs sed -i '' 's/\.\.\/old\/location\/utils/\.\.\/new\/location\/utils/g'

注意：正则需转义路径中的特殊字符，该方式可能误匹配字符串中的相同片段，大型项目谨慎使用。

方案三：npm专用迁移工具 #

使用typescript-migrate-files工具，它会自动扫描项目依赖、计算路径并同步修改导入语句：

1. 安装工具：

npm install -g typescript-migrate-files

2. 执行迁移命令：

ts-migrate move ./src/old/path/target.ts ./src/new/path/target.ts

额外注意事项 #

• 操作前务必提交Git代码，避免修改出错无法回滚。
• 执行完修改后，运行npm run build或tsc检查编译错误，确保路径修改正确。
• 团队协作场景下，提交修改后及时告知成员拉取更新，减少冲突概率。

内容的提问来源于stack exchange，提问作者PPo Po