Vue 3 中路径别名（如@）由构建工具（Vite）配置，用于 import 语句简化路径；需在 vite.config.js 和 tsconfig.json 中同步设置；局部注册通过 <script setup> 导入即生效，全局注册及批量注册同样依赖该别名提升可维护性。
在 Vue 3 项目中，组件注册本身不直接使用别名，但路径引用环节（尤其是 import 语句）高度依赖别名来简化写法。真正起作用的是构建工具（如 Vite）配置的路径别名，它让 import 时能用 @/components/Button.vue 替代冗长的相对路径，从而让全局或局部注册更清晰、可维护。
配置 @ 别名指向 src 目录
这是所有简化路径的基础。Vite 默认不带该别名，需手动在 vite.config.js（或 vite.config.ts）中设置：
- 导入 path 模块，并用 path.resolve(__dirname, 'src') 获取绝对路径
- 在 resolve.alias 中添加 '@': path.resolve(__dirname, 'src')
- 若使用 TypeScript，还需在 tsconfig.json 的 compilerOptions.paths 中同步配置，否则编辑器会报红
局部注册时用 @ 引入组件
这是最常用、最推荐的方式。在单文件组件中，直接用 @ 别名 import 组件，setup 语法糖会自动完成局部注册：
Ainative Vue Sdk
下载
使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景：(1) 安装 `@ainative/vue-sdk`，(2) 在 Vue 组件中使用 `useChat` 组合式函数，(3) 提供……
- <script setup> 中写：import MyButton from '@/components/MyButton.vue'
- 无需再写 components: { MyButton }，导入即注册
- 模板中可直接使用 <MyButton /> 或 <my-button />
全局注册时也靠 @ 简化 import
虽然全局注册发生在 main.js/ts，但每个 import 语句同样受益于别名：
立即学习“前端免费学习笔记（深入）”；
- 传统写法：import BaseButton from './src/components/BaseButton.vue'
- 用 @ 后：import BaseButton from '@/components/BaseButton.vue'
- 配合链式调用：app.component('BaseButton', BaseButton).component('BaseInput', BaseInput)
批量全局注册 + @ 别名更高效
当组件数量较多时，可结合 import.meta.glob 自动扫描目录，此时 @ 别名仍参与路径解析：
- 在 src/components/index.ts 中写：const components = import.meta.glob('@/components/**/index.vue')
- 遍历 components 对象，提取文件名作为组件名，调用 app.component(name, module.default)
- 所有路径都基于 @ 展开，新增组件只需放对位置，无需改注册逻辑
