Vue 3 的 推动 SFC 结构标准化,通过语法约束与社区共识统一逻辑入口、按“输入→状态→逻辑→输出”分层声明、组件名与文件路径强绑定、样式默认 scoped 隔离。

Vue 3 的 <script setup></script> 本身就在推动单文件组件(SFC)结构标准化——它通过语法约束、自动行为和社区共识,把“怎么组织代码”这件事从自由发挥变成了有章可循。关键不在于加多少规则,而在于用好它天然支持的几条主线。
统一使用 <script setup></script> 作为逻辑主入口
整个组件的响应式逻辑、组合式函数调用、props/emits 声明都集中在此区块,不再混用普通 <script></script>。只有在极少数场景(如需声明 inheritAttrs: false 或插件扩展选项)才额外加一个非-setup 的 <script></script> 块,且必须明确其不可替代性。
- 所有顶层声明(
ref、computed、onMounted等)默认暴露给模板,无需return - 导入即可用:组件、指令、工具函数直接 import 后就能在
中使用 - 避免在同一个 .vue 文件里出现两个
<script></script>块,除非真有 setup 无法覆盖的需求
按职责分层声明,顺序固定
推荐按“输入 → 状态 → 逻辑 → 输出”顺序书写,形成可预期的阅读流:
-
Props 和 Emits 定义靠前:用
defineProps和defineEmits显式声明接口,TypeScript 用户可直接写类型字面量 -
响应式状态紧随其后:
ref、reactive、computed集中放置,避免散落在方法中间 -
业务逻辑与生命周期钩子居中:
onMounted、watch、自定义函数等保持语义分组 -
需要暴露给父组件的方法或值,最后用
defineExpose明确列出,不依赖默认全暴露
组件命名与文件路径强绑定
文件名即组件名,采用 PascalCase(大驼峰),且大小写敏感:
-
UserProfile.vue→ 组件名自动为UserProfile,模板中写作 - 路径导入必须与文件名完全一致:
import UserProfile from './components/UserProfile.vue' - 避免 kebab-case 文件名(如
user-profile.vue),否则在 DOM 模板中易与原生标签混淆,且破坏 IDE 补全一致性
样式与作用域默认隔离
是标准结构的一部分,不是可选项:
- 所有组件级样式必须加
scoped,防止样式污染 - 若需穿透或全局样式,用
:deep()、:global()或单独块,但需加注释说明理由 - 不鼓励在组件内写无作用域的 CSS,除非是设计系统级原子类(如
text-sm)且已纳入统一 CSS-in-JS 或 utility-first 规范
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










