Nuxt · NUXT0034

Avoid auto-import name collisions

Flags auto import collision in Nuxt imports code before it leaks into runtime behavior.
NUXT0034vite-doctor/nuxtimportswarnSuggestion

Run this rule

pnpm nuxt doctor --rules nuxt/imports/no-auto-import-collision

Why it matters

Auto-imports are global within a project. Explicit names and imports prevent local code from shadowing framework composables.

Remove auto import collision, or move it to the Nuxt runtime/API that owns that behavior.

Example

Avoid auto-import name collisions

Before

export function useRoute() {
  return { path: '/custom' }
}

After

export function useCustomRoute() {
  return { path: '/custom' }
}
Copyright © 2026