Go批量重命名文件需遍历目录、按规则生成新名、用os.Rename安全改名；须防覆盖、正确处理路径、支持序号/前缀/后缀/扩展名替换，并提供dry-run、存在检查、错误提示等安全机制。
使用 Go 语言批量重命名目录下的所有文件，核心在于：遍历目录、按规则生成新文件名、调用 os.Rename 安全改名。关键要避免覆盖、处理路径、支持常见模式（如序号、前缀、后缀、扩展名替换）。
1. 基础遍历 + 简单序号重命名
适用于将目录下所有文件统一改为 file_001.ext、file_002.ext 这类格式：
- 用
filepath.WalkDir或os.ReadDir获取文件列表（推荐后者，更轻量且不递归） - 过滤掉子目录，只处理普通文件
- 用
fmt.Sprintf("file_%03d%s", i, ext)生成带零填充的新名 - 拼接完整旧/新路径时，始终用
filepath.Join(dir, name)，避免路径拼接错误
2. 支持自定义规则（前缀/后缀/扩展名替换）
通过命令行参数或配置灵活控制行为，例如：
-
--prefix "backup_"→backup_photo.jpg -
--suffix "_v2"→photo_v2.jpg -
--ext ".png"→ 强制改为 PNG（注意：不转换内容，仅改扩展名） - 组合使用时顺序建议：前缀 + 原文件名（不含扩展）+ 后缀 + 新扩展名
3. 安全性与容错处理
批量操作不可逆，必须做这几件事：
立即学习“go语言免费学习笔记（深入）”；
- 重命名前检查目标文件是否已存在，若存在则跳过或报错（可加
--force覆盖） - 对每个
os.Rename调用检查 error，失败时打印具体文件和原因（如权限不足、跨设备不能 rename） - 建议先加
--dry-run模式：只打印“将把 A 重命名为 B”，不实际执行 - 避免在当前工作目录运行时误处理隐藏文件（如
.git），可用strings.HasPrefix(name, ".")过滤
4. 完整示例代码片段（含 dry-run 和序号模式）
以下是一个最小可行脚本结构（省略 import）：
func main() {
dir := flag.String("dir", ".", "目标目录")
prefix := flag.String("prefix", "", "新前缀")
suffix := flag.String("suffix", "", "新后缀")
newExt := flag.String("ext", "", "新扩展名（含点，如 '.txt'）")
dryRun := flag.Bool("dry-run", false, "仅预览不执行")
flag.Parse()
files, _ := os.ReadDir(*dir)
for i, f := range files {
if !f.IsDir() && !strings.HasPrefix(f.Name(), ".") {
oldPath := filepath.Join(*dir, f.Name())
nameOnly := strings.TrimSuffix(f.Name(), filepath.Ext(f.Name()))
ext := *newExt
if ext == "" {
ext = filepath.Ext(f.Name())
}
newName := fmt.Sprintf("%s%s%s%s", *prefix, nameOnly, *suffix, ext)
newPath := filepath.Join(*dir, newName)
if *dryRun {
fmt.Printf("[DRY] %s → %s\n", f.Name(), newName)
continue
}
if _, err := os.Stat(newPath); err == nil {
fmt.Printf("⚠️ 跳过：%s 已存在\n", newName)
continue
}
if err := os.Rename(oldPath, newPath); err != nil {
fmt.Printf("❌ 失败：%s → %s ：%v\n", f.Name(), newName, err)
} else {
fmt.Printf("✅ %s → %s\n", f.Name(), newName)
}
}
}
}
