goimports-reviser命令行参数全解析：解锁高效导入管理的7个技巧

【免费下载链接】goimports-reviserRight imports sorting & code formatting tool (goimports alternative)项目地址: https://gitcode.com/gh_mirrors/go/goimports-reviser

goimports-reviser是一款强大的Go语言导入管理工具，作为goimports的替代方案，它能帮助开发者自动排序导入、移除未使用的包并优化代码格式。本文将详细解析其命令行参数，分享7个实用技巧，让你的Go项目导入管理更高效。

核心参数快速入门

1. 基础清理：移除未使用的导入

-rm-unused参数是日常开发中最常用的功能之一，它能自动检测并删除代码中未使用的导入语句，保持代码整洁。

使用示例：

goimports-reviser -rm-unused main.go

2. 版本化包自动别名

对于带版本号的包（如github.com/go-pg/pg/v9），-set-alias参数会自动为其创建简洁别名：

goimports-reviser -set-alias main.go

处理后会生成类似pg "github.com/go-pg/pg/v9"的导入声明，提升代码可读性。

图：使用-set-alias参数前后的导入对比效果

高级导入排序技巧

3. 自定义导入分组顺序

通过-imports-order参数可以完全掌控导入分组的排列顺序，默认值为std,general,company,project。你可以根据项目需求调整：

goimports-reviser -imports-order "std,project,general" main.go

支持的分组关键字包括：

• std：标准库
• general：通用第三方库
• company：公司内部库（需配合-company-prefixes使用）
• project：项目本地包
• blanked：下划线别名导入
• dotted：点别名导入

4. 公司内部包隔离

使用-company-prefixes参数指定公司域名前缀，让内部包与第三方库清晰分离：

goimports-reviser -company-prefixes "github.com/yourcompany" main.go

此参数接受逗号分隔的多个前缀值，帮助大型团队维护一致的导入规范。

输出控制与集成技巧

5. 多输出模式灵活选择

-output参数提供三种输出方式，满足不同使用场景：

• file（默认）：直接修改文件
• stdout：输出到控制台
• write：修改文件并配合-list-diff列出变更文件

示例：查看格式化效果而不修改文件

goimports-reviser -output stdout main.go

6. 批量处理与缓存优化

对目录进行递归处理时，结合-recursive和-use-cache参数能大幅提升效率：

goimports-reviser -recursive -use-cache ./src

-use-cache会将处理结果缓存到~/.cache/goimports-reviser目录，避免重复处理未变更文件。

特殊场景处理方案

7. 生成文件处理

默认情况下，工具会跳过包含// Code generated注释的生成文件。如需处理这些文件，使用-apply-to-generated-files参数：

goimports-reviser -apply-to-generated-files generated.go

图：goimports-reviser的导入处理流程示意图

实用组合命令示例

代码提交前检查：

goimports-reviser -rm-unused -format -set-exit-status ./...

结合-set-exit-status，当检测到需要格式化的文件时会返回状态码1，可集成到Git hooks中实现提交前自动检查。

项目标准化格式化：

goimports-reviser -recursive -rm-unused -format -company-prefixes "github.com/yourcompany" -imports-order "std,general,company,project" ./src

通过灵活组合这些参数，goimports-reviser能帮助团队建立统一的导入规范，减少代码审查中的格式争议，让开发者更专注于业务逻辑实现。工具源码中与命令行参数解析相关的核心实现可参考main.go文件。

【免费下载链接】goimports-reviserRight imports sorting & code formatting tool (goimports alternative)项目地址: https://gitcode.com/gh_mirrors/go/goimports-reviser