---
url: /docs/adr/007-oxfmt-sorts-imports.md
---
# 决策 007：统一导入顺序

**状态：** 已采纳。**日期：** 2026-09-12。

## 问题

只靠编辑器整理导入，结果取决于开发者打开过哪些文件，生成代码和 CI 也没有统一检查。

## 决策

`.oxfmtrc.json` 的 `sortImports` 交给 Oxfmt。编辑器保存、提交检查与 CI 使用同一规则，不增加独立导入排序工具。

保留默认内部路径模式：`@repo/*` 作为其他包，`#*` 作为本包内部文件。副作用导入不自动排序，避免改变环境初始化和样式加载顺序。

## 影响

导入顺序可以确定且可检查。格式化不会自动删除全部无用导入，静态检查仍负责发现；出现冲突时按格式化器结果处理。

`db/scripts/seed.ts` 的环境配置副作用导入等依赖执行顺序，不能因为看起来不整齐就手动移动。相关决策：[包内导入](./006-subpath-imports.md)。
