大型vue/ts项目应统一导出风格:默认导出聚焦主干(如单组件),命名导出承载扩展(如工具函数、类型、hook);混合导出需分层清晰,禁用隐式挂载;导入端须语义化命名。

在大型 Vue 或 TypeScript 项目中,导出风格不统一容易导致模块引用混乱、重构困难、命名冲突甚至运行时错误。关键不是“能不能用”,而是“怎么用才稳”。核心原则是:默认导出聚焦主干,命名导出承载扩展,两者分工明确、边界清晰。
按模块职责决定导出类型
一个文件该用 export default 还是 export,取决于它对外暴露的“角色”:
- 组件主体(如
ProductList.vue)——只做一件事、被频繁单独引入,用export default - 工具集合(如
utils/date.ts)——含多个函数、常量、类型,全部用命名导出:export const formatDate = ...、export function parseISO() {...} - 配置对象(如
config/api.ts)——若只有单个主配置对象,用默认导出;若同时导出环境变量、校验规则等辅助项,则默认 + 命名混合导出
命名导出优先用于可组合能力
当模块需要支持“按需导入”或“类型即契约”时,命名导出更可靠:
- 导出类型定义(
interface Product、type ApiError)必须用命名导出,否则无法在import type中精确引用 - 导出 hook 函数(
useCart、useAuth)建议命名导出,便于测试文件单独导入、避免默认导出带来的命名歧义 - 导出多个同构组件(如
ButtonPrimary、ButtonSecondary)不用默认导出,改用命名导出 + 统一前缀,语义更直接
混合导出要显式分层,禁用隐式默认
允许一个文件同时有默认和命名导出,但结构必须一目了然:
- 默认导出放在文件最上方或最下方,且只有一处;所有命名导出集中声明,不穿插在逻辑中间
- 禁止在默认导出对象内部“偷偷”挂载命名成员(如
export default { ... , helpers: { foo() {} } }),这会让 helper 无法被 tree-shaking,也不利于类型推导 - 若需转发其他模块的能力,用重新导出(
export { Foo } from './foo')而非在默认对象里复制引用
导入端保持语义化命名,不依赖默认别名惯性
即使用了 export default,导入时也应赋予有意义的变量名:
- 避免
import Comp from './Comp.vue'这类无信息命名;写成import ProductCard from './ProductCard.vue' - 对同一模块的命名导出,坚持使用原始名或
as显式重命名(import { createAPI } from './api' as createProductAPI),不靠记忆猜含义 - 团队内约定:所有组件默认导出的导入名必须与文件名/组件
name选项一致(如Modal.vue→import Modal from './Modal.vue')










