Repolode
PyCQA

PyCQA/isort

一个自动排序并分组 Python import 语句的命令行工具和库。

Star
6,962
Fork
724
未关闭 Issue
78
最近提交
9小时前

这是什么?

isort 会按字母顺序对 Python 的 import 语句排序,并按类型自动划分为标准库、第三方库、本地模块等分组。它既可以在命令行中对单个文件或整个目录运行,也可以在 Python 代码中通过库函数调用。

工具提供 --diff 选项,可在应用修改前预览变更;--check-only 模式会列出 import 顺序不正确的文件,适合用于 pre-commit 钩子或 CI 检查。长的 from 导入换行方式有 12 种可配置模式,并可设置为与 black 格式化工具兼容。

此外,isort 提供多种编辑器插件、官方 pre-commit 支持以及 Git 钩子。运行需要 Python 3.11 或更高版本,但也能格式化 Python 2 代码。

核心功能

  • 01按字母顺序排列 import 并划分为可配置的分组。
  • 02提供 --diff 预览和 --check-only 检查模式,便于 CI 和 pre-commit 使用。
  • 03长 import 语句提供 12 种多行换行模式。
  • 04可配置为与 black 格式化工具兼容。
  • 05既可通过命令行使用,也可作为 Python 库调用。

适用场景

  • 统一大型 Python 代码库中的 import 风格。
  • 在 CI 或 pre-commit 钩子中强制检查 import 顺序。
  • 在编辑器中保存时自动整理 import。
  • 在脚本或其他 Python 工具中调用 import 排序功能。

标签

常见问题

isort 是什么?
一个自动排序并分组 Python import 语句的命令行工具和库。 isort 会按字母顺序对 Python 的 import 语句排序,并按类型自动划分为标准库、第三方库、本地模块等分组。它既可以在命令行中对单个文件或整个目录运行,也可以在 Python 代码中通过库函数调用。
isort 可以免费使用吗?用的什么许可证?
isort 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
isort 还在维护吗?
活跃维护中。isort 最近一次提交是在 2026年10月21日。
isort 适合用来做什么?
统一大型 Python 代码库中的 import 风格。 在 CI 或 pre-commit 钩子中强制检查 import 顺序。 在编辑器中保存时自动整理 import。 在脚本或其他 Python 工具中调用 import 排序功能。
在哪里获取 isort?
源代码和安装说明在 GitHub 上:https://github.com/PyCQA/isort

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目