Flutter项目改包名后，如何批量将package导入转为相对导入？

方法一：用Dart脚本自动处理（最精准可靠） #

因为每个文件的相对路径不同，正则全局替换无法适配所有场景，写个小脚本可以精准计算相对路径：

1. 在项目根目录创建convert_imports.dart文件：

import 'dart:io';
import 'path/path.dart' as path;

void main() {
  // 替换成你的旧包名
  const oldPackageName = 'xxx_xxx_xxx';
  final libDir = Directory('lib');

  if (!libDir.existsSync()) {
    print('lib目录不存在');
    return;
  }

  // 遍历所有.dart文件
  libDir.listSync(recursive: true).forEach((entity) {
    if (entity is File && entity.path.endsWith('.dart')) {
      processFile(entity, oldPackageName);
    }
  });
}

void processFile(File file, String oldPackageName) {
  final content = file.readAsStringSync();
  final packageImportRegex = RegExp(r"import 'package:" + oldPackageName + r"/(.+?)';");
  final newContent = content.replaceAllMapped(packageImportRegex, (match) {
    final targetPath = match.group(1)!;
    final targetAbsolutePath = path.join(Directory.current.path, 'lib', targetPath);
    final currentAbsolutePath = file.path;
    var relative = path.relative(targetAbsolutePath, from: path.dirname(currentAbsolutePath));
    if (!relative.startsWith('../') && !relative.startsWith('/')) {
      relative = './$relative';
    }
    return "import '$relative';";
  });

  if (newContent != content) {
    file.writeAsStringSync(newContent);
    print('已更新：${file.path}');
  }
}

2. 修改脚本里的oldPackageName为你原来的包名（比如xxx_xxx_xxx）
3. 在项目根目录执行脚本：

dart run convert_imports.dart

脚本会自动遍历lib下所有Dart文件，将所有package:xxx_xxx_xxx/...的导入替换为对应相对路径，适配每个文件的位置。

方法二：VS Code结合正则+分层处理（适合结构简单的项目） #

如果项目目录结构规整，可通过VS Code全局替换快速处理：

1. 按Ctrl+Shift+F打开全局搜索，切换到替换标签
2. 搜索框输入正则：import 'package:xxx_xxx_xxx/(.+?)';（替换xxx为你的旧包名）
3. 替换框根据文件层级输入对应前缀：
   • 根目录下的文件用import './$1';
   • 一级子目录下的文件用import '../$1';
   • 更深层级的文件对应增加../数量
4. 先点击「预览」确认替换结果，再执行替换

这种方法需要分批次处理不同层级的文件，适合目录复杂度低的项目。

注意事项 #

• 批量替换前一定要备份项目或提交Git，避免出错无法恢复
• 替换完成后运行flutter pub get和flutter run验证导入是否正常
• 脚本只会匹配你指定的旧包名导入，第三方包的package导入会自动忽略

内容的提问来源于stack exchange，提问作者La Pyae