isort 5.12.0在pre-commit与Bitbucket Pipelines中导入排序异常原因咨询

出现本地pre-commit使用isort 5.12.0排序错误、但Bitbucket Pipelines环境排序正常的情况，主要是以下几种常见原因：

1. isort配置文件不一致 #

本地与Pipeline环境的isort配置存在差异：

• Pipeline环境的配置文件（如pyproject.toml、.isort.cfg或setup.cfg）中，正确通过known_first_party = module1标记了module1为项目第一方包，isort会将这类顶级第一方导入放在第三方包（dagster、jsonschema等）之后、同项目子模块导入之前。
• 本地环境的配置缺少该设置，isort无法识别module1是项目内包，误将其归类到“其他”导入组，最终排到了所有第三方导入之后。

2. pre-commit钩子运行环境差异 #

本地pre-commit的isort钩子存在特殊运行逻辑：

• 钩子可能指定了额外参数（如--settings-path指向非项目根的配置文件），或者pre-commit运行时的工作目录不是项目根，导致isort读取不到正确的第一方包配置。
• Pipeline中直接在项目根目录运行isort命令，读取的是项目根的配置文件，排序逻辑正常生效。

3. pre-commit缓存干扰 #

本地pre-commit会缓存钩子环境和运行状态：

• 如果之前修改过isort配置但未清理pre-commit缓存，钩子可能仍使用旧配置逻辑运行，导致排序错误。而Pipeline每次都是全新构建环境，不存在缓存问题，配置能正常生效。

4. Python环境路径差异 #

本地Python环境的sys.path未包含项目根目录：

• isort判断包归属时依赖Python路径配置，若本地运行pre-commit时项目根不在Python搜索路径中，isort无法识别module1是本地包，从而错误排序；Pipeline环境则正确配置了Python路径，能准确识别第一方包。

内容的提问来源于stack exchange，提问作者Victor Sotillo