前端开发规范（阿里规范为模板）零基础入门到精通，收藏这篇就够了

全部采用小写方式，以中线分割正确示例：mail-management-system错误示例：mail_management-system / mailManagementSystem个人感悟：今天看了才知道原来项目也有命名规范，在学习阶段的使用莫名的热衷于大驼峰命名，甚至现在在工作中也有人命名里有.比如aaa-bbb-ccc.ddd.ui之类的，也是有点无语到。

Python_chichi

360人浏览 · 2025-12-25 06:30:00

Python_chichi · 2025-12-25 06:30:00 发布

一.编程规范

（一）命名规范

1.1.1 项目命名

全部采用小写方式，以中线分割

正确示例：mail-management-system

错误示例：mail_management-system / mailManagementSystem

个人感悟：今天看了才知道原来项目也有命名规范，在学习阶段的使用莫名的热衷于大驼峰命名，甚至现在在工作中也有人命名里有.比如aaa-bbb-ccc.ddd.ui之类的，也是有点无语到。

1.1.2 目录命名

全部采用小写方式，以中划线分割，有复数结构时，要采用复数命名法，缩写不用复数。

正确示例：scripts / styles / components / images / utils

错误示例：script / style / demo_scripts / demoStyles

【特殊情况】在Vue项目中的components中的组件目录下，使用kebab-case命名，其他所有目录也使用kebab-case命名

ps:kebab-case就是单词之间用连字符（-）分割且所有字母小写例如 my-file-name

正确示例：head-search / page-loading / authorized / notice-icon

错误示例：HeadSearch / PageLoading

个人感悟：工作中还是会遇到其他同事用大驼峰的命名，还有componets / SelectUser 最标准的错误啊。下面是对应的模块，怎么说呢，虽然能看懂但是既然违法规范那还是改掉好了。

1.1.3 JS、CSS、SCSS、HTML、PNG 文件命名

全部采用小写方式，以分割线分割。

正确示例：render-dom.js / signup.css / index.html / company-logo.png

错误示例：renderDom.js / UserManagement.html

个人感悟：还是老问题，实际工作中出现了blablalogo.png 还有 blablaReview.js种种命名，小项目一个两个还ok，但是随着开发进行下去后真的看的很乱。

1.1.4 命名严谨性

代码中的命名严禁使用拼音与英文混合的方式，更不允许直接使用中文的方式。正确的英文拼写和语法可以让阅读这易于理解，避免歧义。注意及时纯拼音命名方式也要避免采用

正确示例：henan / luoyang / rmb 等国际通用的名称，可视同英文

错误示例：DaZhePromotion [打折] / getPingfenByName() [评分] / int 某变量 = 3

个人感悟：看到这一条的时候，我真的脸红到不行，想到实习的时候，做一个MES报工软件，命名还有BaoGongDetail.vue，BgInfo.vue 之类的，当时主管不懂前端让我自己弄，也没说我，等我走了之后交接，给人家读代码留下了很大隐患啊（来问过我好多次）。这里也祝福一下接管这个项目的人，祝你顺利peace。不过语义化这个东西真的很难，拼音有不同读法会有异议，英文的话我这种文盲又会看不懂，只能说一定要和同事协商好。

（二）HTML规范

1.2.1 HTML 类型

推荐使用HTML5 的文档类型申明：

（建议使用 text/html 格式的 HTML。避免使用 XHTML 。）

正确示例

<!doctype html>

<meta charset="UTF-8" />

<meta http-equiv="X-UA-Compatible" content="IE=Edge" />

<title>Page title</title>

<div id="app"></div

个人感悟：这个规范应该很多人用不到，毕竟现在网上学习的教程第一步都是vscode！快捷生成代码，希望自己以后工作不会遇到xhtml吧。

1.2.2 缩进

缩进进行2个空格（一个tab）

嵌套的节点应该缩进。

个人感悟：印象里这个在网课里也有教，vscode或者idea中可以设置一个tab是多少个空格，然后也有很多插件能格式化你的代码，所以这个问题应该没啥好说的。但是有时候新电脑来了，直接装个vscode开始写有时候是会有缩进问题。还有就是现在复制AI代码，很容易有缩进问题，这个还是要注意一下，尤其是我这种AI重度依赖。

1.2.3 分块注释

在每一格块级元素，列表元素和表格元素后，加上一对html注释。

个人感悟：这个挺好的，真的建议大家都分块注释，缩放之后真的会清晰很多。

1.2.4 语义化标签

HTML5中新增了很多语义化标签，应该优先使用语义化标签，避免一个页面都是div或者p标签。

正确示例：

错误示例：

    <p></p>

个人感悟：这个咋说呢很多时候确认会全用div啊，尤其是这些语义化标签没有特殊样式，哪怕有特殊样式还是会有很多人选择div。从大格局来说这些语义化标签确实能对特殊人士有帮助，后续我个人也会尽量使用。在用element-ui和element-plus的时候，还是语义化挺明显的。复制粘贴来的都很难抗拒，但是自己写的话总会偷懒或者不在意的。

1.2.5 引号

使用双引号(" ")而不是单引号(’ ')

正确示例：

错误示例：

个人感悟：这个没啥好说的，就是大家都用双引号，单引号也能用只是多少怪怪的。

（三）CSS规范

1.3.1 命名

类名使用小写字母，以中划线分割

id采用驼峰式命名

scss中的变量、函数、混合、placeholder采用驼峰式命名

ID和class的名称使用可以反应元素目的和用途的名称，或其他统一名称，来代替晦涩的名称。

不推荐：

.fw-800 {

    font-weight: 800;

}

.red {

    color: red;

}

1.3.2 选择器

1）css 选择器中避免使用标签名

从结构、表现、行为分离的原则来看，应该尽量避免css中出现HTML标签，并且在css选择器中出现标签名会存在潜在的问题。

2）使用直接子选择器

很多前端开发人员写选择器链的时候不使用直接子选择器，有时这回损耗性能。

不推荐：

.content .title {

    font-size:2rem;

}

1.3.3 尽量使用缩写属性

不推荐：

border-top-style: none;

font-family: palatino, georgia, serif;

font-size: 100%;

line-height: 1.6;

padding-bottom: 2em;

padding-left: 1em;

padding-right: 1em;

padding-top: 0;

推荐：

border-top: 0;

font: 100%/1.6 palatino, georgia, serif;

padding: 0 1em 2em;

个人感悟：这个应该也是共识了，像这个上下左右边框边距之类的东西，最好能缩写就缩写。

1.3.4 每个选择器及属性独占一行

不推荐：

button { width: 100px; height: 50px; color: #fff; background: #00a0e9; }

1.3.5 省略0后面的单位

不推荐：

padding-bottom: 0px;

推荐：

padding-bottom:0;

个人感悟：这个怎么说呢，有时候你根据原型图去改px，改到后面发现为0好看的时候，你确实会容易忘记，这东西也不分错误正确，智者见智，要强制规定也行吧。不过flex-basis要注意0%和0px的差距哦，这也是网上查到了我自己没遇到。

1.3.6 避免使用ID选择器及全局标签选择器防止污染全局样式

不推荐：

#header {

    padding-bottom:0px;

}

推荐：

.header {

    padding-bottom:0px;

}

个人感悟：这一点又和前面的语义化标签对应上了，确实是要注意的一点，你也不想写着写着突然前面的样式被污染，很恶心的。

（四）LESS规范

1.4.1 代码组织

1）将公共less文件放置在style/less/common 文件夹

例如：// color.less , common.less

2）按以下顺序组织（@import、变量声明、样式说明）

举例：

@import “mixins/size.less”;

@default-text-color:#333;

.page {

    width:960px;

    margin:0  auto;

}

个人感悟：这个确实挺好的，放在对应的文件夹有规定总是好的，按照对应的顺序组织，好过你这里一个变量那里一个变量，真的会让人头晕的。

1.4.2 避免嵌套层级过多

将嵌套深度限制在3级。对于超过4级的嵌套，给予重新评估。可以避免出现过于详实的css选择器。避免大量的嵌套规则。当可读性受到影响时，将之打断，避免多余20行的嵌套出现。

不推荐：

.main{

    .title{

            .name{

                    color:#fff        

            }

    }

}

推荐：

.title{

    .name{

             color:#fff        

    }

}

个人感悟：看到这个规范又不好意思了，我写less的时候都不止四层嵌套，五六层都有，混乱的不行，我自己看到都晕。有时候这样还不如直接css搞定。之后我一定严格照着这个标准啊。

（五）Javascript规范

1.5.1 命名

1）采用小写驼峰命名 lowerCamelCase，代码中的命名均不能以下划线或美元符号结束

错误示例：_name / name_ / name$

2）方法名、参数名、成员变量、局部变量都统一使用小驼峰风格。

正确示例：localValue / getHttpMessage() / inputUserId

*其中 method 方法命名必须是动词或者动词+名词的形式*

正确示例：saveShopCarData / openShopCarInfoDialog

错误示例：save / open / show / go

增删改查又统一的单词：add / update / delete / get / detail 为了统一还有一个动词表太长了这里就不放了。可以自己上网查。

3）常量命名全部大写，单词间用下划线隔开，力求语义完整，不要嫌名字长。

正确示例：MAX_STOCK_COUNT

错误示例：MAX_COUNT

个人感悟：不要觉得名字太长了，这个部分确实语义化更重要，看不懂怎么样用

1.5.2 代码格式

1）使用两个空格进行缩进

2）不同逻辑、不同语义、不同业务的代码之间插入一个空行分隔开来。

个人感悟：这两个前面也有提及到，一个就是用格式化工具可以辅助你。还有一个就是确确实实能提升你代码的可读性，包括在收起块级的代码之后，更加明显。

1.5.3 字符串

统一使用单引号，不使用双引号，在创建html字符串时有好处

正确示例：

let str = ‘foo’

let testDiv = ‘

’

错误示例：

let str = “foo”

let testDiv = “

”

个人感悟：这个和前面的html中用双引号对应起来了，遵循就好了。不然创建html时有冲突。

1.5.4 对象声明

1）使用字面量创建对象

正确示例：let user = {};

错误示例：let user = new Object();

2）使用字面量代替对象构造器

正确示例：

let user = {

    age:0,

    name:1,

    city:3

};

错误示例：

let user = new Object();

user.age = 0;

user.name = 0;

user.city = 0;

个人感悟：emm，基本没见过有人用对象构造器吧，除了面试题里有看到。

1.5.5 使用ES6+

必须优先使用ES6+ 中新增的语法糖和函数。比如箭头函数、await/async 、解构、let 等等

个人感悟：这个必须强制推行啊，受不了一些人还在varvarvar。

1.5.6 括号

下列关键字后必须有大括号（即使代码块内容只有一行）

if,else,for,while,do, switch,try,catch,finally,with。

个人感悟：就别图麻烦不写括号里，这一点都不酷啊。

1.5.7 undefined判断

永远不要直接使用undefined进行变量判断；使用typeof和字符串’undefined’对变量进行判断。

正确示例：

if(typeof person === ‘undefined’){

...

}

错误示例：

if(person === undefined){

...

}

个人感悟：既然这么写了肯定有道理，我记得面试题里也有typeof来判断的，反正肯定比直接===undefined稳健，天知道会出现什么问题。

1.5.8 条件判断和循环最多三层

条件判断能使用三目运算符和逻辑运算符解决的，就不要使用条件判断，但是谨记不要写太长的三目运算符。如果超过三层请抽成函数，并写清楚注释。

个人感悟:条件判断和循环绝对是屎山常出现的地方，一层套一层，久了你就全忘记了。能用不是很长的三目运算符就用吧。不过也要考虑可读性。

1.5.9 this 的转换命名

对上下文this的引用只能使用’self’来命名。

个人感悟：暂时没遇到过，可能是做的都是简单项目。有规范就遵守好了。

1.5.10 慎用 console.log

因console.log大量使用会有性能问题，所以在非webpack项目中谨慎使用log功能。

个人感悟：我自己调试的时候就很爱用console.log，看到这个规范查了一下，好像是会导致内存泄漏，也就是垃圾回收机制不会释放掉，项目久了就会有问题了。反正千万别让console.log上生产。

写到这里发现快下班了，剩下的以后有空再写吧。内容基本都是阿里前端规范上抄下来的，然后自己写点感悟，也是写给自己看的，确实有帮助，不过光看也没用，今后项目中争取和同事都用起来吧。也只能希望同事能同意了。

二.Vue项目规范

（一） Vue 编码规范

2.1.1 组件规范

2.1.2 模板中使用简单的表达式

2.1.3 指令都使用缩写形式

2.1.4 标签顺序保持一致

2.1.5 必须为 v-for 设置键值 key

2.1.6 v-show 与 v-if 选择

2.1.7 script 标签内部结构顺序

2.1.8 Vue Router 规范

（二） Vue 项目目录

2.2.1 基础

2.2.2 使用 Vue-cli 脚手架

2.2.3 目录说明

2.2.4 注释说明

2.2.5 其他

2025开年，AI技术打得火热，正在改变前端人的职业命运：

阿里云核心业务全部接入Agent体系；

字节跳动30%前端岗位要求大模型开发能力；

腾讯、京东、百度开放招聘技术岗，80%与AI相关……

大模型正在重构技术开发范式，传统CRUD开发模式正在被AI原生应用取代！

最残忍的是，业务面临转型，领导要求用RAG优化知识库检索，你不会；带AI团队，微调大模型要准备多少数据，你不懂；想转型大模型应用开发工程师等相关岗，没项目实操经验……这不是技术焦虑，而是职业生存危机！

曾经React、Vue等热门的开发框架，已不再是就业的金钥匙。如果认为会调用API就是懂大模型、能进行二次开发，那就大错特错了。制造、医疗、金融等各行业都在加速AI应用落地，未来企业更看重能用AI大模型技术重构业务流的技术人。

如今技术圈降薪裁员频频爆发，传统岗位大批缩水，相反AI相关技术岗疯狂扩招，薪资逆势上涨150%，大厂老板们甚至开出70-100W年薪，挖掘AI大模型人才！

在这里插入图片描述

不出1年 “有AI项目开发经验”或将成为前端人投递简历的门槛。

风口之下，与其像“温水煮青蛙”一样坐等被行业淘汰，不如先人一步，掌握AI大模型原理+应用技术+项目实操经验，“顺风”翻盘！

大模型目前在人工智能领域可以说正处于一种“炙手可热”的状态，吸引了很多人的关注和兴趣，也有很多新人小白想要学习入门大模型，那么，如何入门大模型呢？

下面给大家分享一份2025最新版的大模型学习路线，帮助新人小白更系统、更快速的学习大模型！

2025最新版CSDN大礼包：《AGI大模型学习资源包》免费分享**

一、2025最新大模型学习路线

一个明确的学习路线可以帮助新人了解从哪里开始，按照什么顺序学习，以及需要掌握哪些知识点。大模型领域涉及的知识点非常广泛，没有明确的学习路线可能会导致新人感到迷茫，不知道应该专注于哪些内容。

我们把学习路线分成L1到L4四个阶段，一步步带你从入门到进阶，从理论到实战。

L1级别:AI大模型时代的华丽登场

L1阶段：我们会去了解大模型的基础知识，以及大模型在各个行业的应用和分析；学习理解大模型的核心原理，关键技术，以及大模型应用场景；通过理论原理结合多个项目实战，从提示工程基础到提示工程进阶，掌握Prompt提示工程。

L2级别：AI大模型RAG应用开发工程

L2阶段是我们的AI大模型RAG应用开发工程，我们会去学习RAG检索增强生成：包括Naive RAG、Advanced-RAG以及RAG性能评估，还有GraphRAG在内的多个RAG热门项目的分析。

L3级别：大模型Agent应用架构进阶实践

L3阶段：大模型Agent应用架构进阶实现，我们会去学习LangChain、 LIamaIndex框架，也会学习到AutoGPT、 MetaGPT等多Agent系统，打造我们自己的Agent智能体；同时还可以学习到包括Coze、Dify在内的可视化工具的使用。

L4级别：大模型微调与私有化部署

L4阶段：大模型的微调和私有化部署，我们会更加深入的探讨Transformer架构，学习大模型的微调技术，利用DeepSpeed、Lamam Factory等工具快速进行模型微调；并通过Ollama、vLLM等推理部署框架，实现模型的快速部署。

整个大模型学习路线L1主要是对大模型的理论基础、生态以及提示词他的一个学习掌握；而L3 L4更多的是通过项目实战来掌握大模型的应用开发，针对以上大模型的学习路线我们也整理了对应的学习视频教程，和配套的学习资料。

二、大模型经典PDF书籍

书籍和学习文档资料是学习大模型过程中必不可少的，我们精选了一系列深入探讨大模型技术的书籍和学习文档，它们由领域内的顶尖专家撰写，内容全面、深入、详尽，为你学习大模型提供坚实的理论基础。（书籍含电子版PDF）

三、大模型视频教程

对于很多自学或者没有基础的同学来说，书籍这些纯文字类的学习教材会觉得比较晦涩难以理解，因此，我们提供了丰富的大模型视频教程，以动态、形象的方式展示技术概念，帮助你更快、更轻松地掌握核心知识。

四、大模型项目实战

学以致用 ，当你的理论知识积累到一定程度，就需要通过项目实战，在实际操作中检验和巩固你所学到的知识，同时为你找工作和职业发展打下坚实的基础。

五、大模型面试题

面试不仅是技术的较量，更需要充分的准备。

在你已经掌握了大模型技术之后，就需要开始准备面试，我们将提供精心整理的大模型面试题库，涵盖当前面试中可能遇到的各种技术问题，让你在面试中游刃有余。

因篇幅有限，仅展示部分资料，需要点击下方链接即可前往获取

2025最新版CSDN大礼包：《AGI大模型学习资源包》免费分享

2048 AI社区

有“AI”的1024 = 2048，欢迎大家加入2048 AI社区

更多推荐

大模型应用中的Agent智能体与workflow工作流：区别、联系及未来趋势详解！

2048 AI社区

东数西算规模化落地背景下，大模型本地化部署的标准端口破局之道

2048 AI社区

打破大模型推理困境：LORE理论框架与SFT-Compo微调方法，提升模型推理效率与准确性！

2048 AI社区

所有评论(0)

查看更多评论

Python_chichi

@Javachichi

已为社区贡献257条内容