讲师中心 微信公众号
AI工具推荐 视频效率加速

Vue 组件命名规范:遵循 PascalCase 与连字符命名

大磊小哥_9892

大磊小哥_9892

发布时间:2026-06-27 08:01:45

|

870人浏览过

|

来源于php中文网

原创

Vue组件命名需区分定义时与使用时:定义时文件名、name选项及注册名统一用PascalCase(如UserProfileCard.vue),基础组件加Base前缀;模板中推荐PascalCase(<UserProfileCard/>),但kebab-case(<user-profile-card/>)也合法;Props用camelCase,自定义事件用kebab-case;非组件文件统一用kebab-case。

vue 组件命名规范:遵循 pascalcase 与连字符命名

Vue 组件命名不是随意选个名字就行,核心是区分“定义时”和“使用时”两种场景,对应不同规则,且必须兼顾可读性、一致性与 HTML 特性。

组件文件名和注册名统一用 PascalCase

所有 .vue 文件名、组件内部 name 选项、以及全局/局部注册时的组件名,都应采用 PascalCase(首字母大写,单词连写)。

  • ✅ 正确示例:UserProfileCard.vue、OrderSummaryPanel.vue、BaseModal.vue
  • ❌ 避免:userprofilecard.vue(全小写)、user-profile-card.vue(kebab-case)、UserProfilecard.vue(大小写不规范)
  • 基础组件建议加 Base 前缀,业务组件可用 Business 或领域词,如 AdminDashboard.vue

模板中使用组件推荐 PascalCase,但 kebab-case 也合法

在单文件组件的 <template> 中,Vue 编译器支持两种写法。PascalCase 更直观体现“这是自定义组件”,而 kebab-case 是 HTML 原生兼容写法。

vue-component-analyzer
vue-component-analyzer

递归分析 Vue 项目组件依赖,从入口文件生成组件层级图,支持 Vue 2/3,输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。

下载
  • ✅ 推荐:<UserProfileCard /> —— 语义清晰,与 JS 导入名一致,IDE 补全友好
  • ✅ 允许:<user-profile-card /> —— 在 DOM 模板或需要严格遵循 HTML 规范时必须用它
  • ⚠️ 注意:不要混用,整个项目保持一种风格,避免 <UserProfileCard> 和 <user-profile-card> 同时出现

Props 和事件名按角色分层命名

组件对外暴露的接口需明确职责边界,命名方式与组件本身不同。

立即学习“前端免费学习笔记(深入)”;

  • Props 用 camelCase:如 userName、isDisabled、maxUploadSize
  • 自定义事件 必须用 kebab-case:如 update-user-info、item-removed、form-submitted
  • 事件名优先动词开头,表达动作意图,避免模糊名词如 change,改用 input-changed 或 value-updated

非组件文件和资源统一用 kebab-case

让文件类型一目了然,减少歧义。

  • 工具函数:date-format.js、api-helper.js
  • 路由配置:router-index.js、routes-admin.js
  • 样式资源:button-primary.css、icon-edit.svg
  • 文件夹名:components-shared、views-dashboard、utils-common

热门AI工具

更多
咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2303

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

4983

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6070

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

5578

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

783

2024.05.22

vue2.0和3.0区别
vue2.0和3.0区别

vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。

1634

2023.07.17

vue3的生命周期有哪些
vue3的生命周期有哪些

vue3的生命周期:1、beforecreate;2、created;3、beforemount;4、mounted;5、beforeupdate;6、updated;7、beforedestroy;8、destroyed;9、activated;10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

11902

2024.02.23

Vue3组合式API与组件开发实战
Vue3组合式API与组件开发实战

本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。

296

2026.02.10

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

100

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app快速上手
uni-app快速上手

共0课时 | 0人学习

Vue 教程
Vue 教程

共42课时 | 17万人学习

Vue3.x 工具篇--十天技能课堂
Vue3.x 工具篇--十天技能课堂

共26课时 | 2.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn