很多新手写 JavaScript 代码最大的问题不是不会写逻辑而是 书写混乱、格式随意缩进乱、不加分号、变量随便命名、代码堆砌一堆。看似代码能跑但是可读性极差、极易出Bug、后期完全无法维护。本篇博客总结一套新手通用、企业通用的 JS 标准书写格式照着写就能写出干净、规范、专业的JS代码。一、为什么要统一JS书写格式可读性高自己和别人都能一眼看懂代码结构减少隐性Bug格式不规范是很多诡异报错的元凶团队协作必备企业开发强制统一编码风格方便调试与迭代结构清晰改代码不翻车二、JS 基础全局书写规范必背缩进规范最重要统一使用 2个空格 或 4个空格缩进全程一致禁止混用Tab推荐新手4个空格缩进结构最清晰。❌ 错误写法缩进混乱function test(){let a1;if(a0){console.log(a)}}✅ 标准规范写法function test() {let a 1;if (a 0) {console.log(a);}}语句必须结尾分号 ;虽然JS可以自动补全分号但绝对不要依赖自动分号极易出现隐秘Bug。✅ 每条语句末尾必须加 ;运算符前后必须加空格赋值、比较、加减乘除等运算符左右必须留空代码更舒展。❌ 不规范let a12;✅ 规范let a 1 2;大括号格式同一行开启企业统一风格左大括号不换行✅ 标准if (flag) {// 代码}❌ 不允许if (flag){}三、变量 常量 书写格式规范声明方式强制规范禁止使用 var全部使用 let / const值不改变用 const值会改变用let命名规范驼峰命名法JS 统一使用 小驼峰命名变量、函数小驼峰 userName常量全大写下划线MAX_COUNT禁止拼音、禁止中文、禁止随意简写✅ 规范示例const PAGE_SIZE 10;let userName “张三”;let userAge 20;❌ 不规范let a 10;let name222 “”;let yonghuMing “”;四、数组、对象标准书写格式数组书写规范简单数组单行书写复杂数组换行对齐✅ 规范let arr [11, 22, 33, 44];let list [{ id: 1, name: “测试1” },{ id: 2, name: “测试2” }];2. 对象书写规范key 后冒号加空格最后一项也可以带逗号兼容规范let userInfo {id: 1001,username: “小明”,age: 18};五、条件、循环语句书写格式if 标准格式无论代码几行必须加大括号禁止单行省略大括号✅ 标准if (score 60) {console.log(“及格”);} else {console.log(“不及格”);}❌ 禁止极易出错if(score60) console.log(“ok”);for / while 规范for (let i 0; i arr.length; i) {console.log(arr[i]);}while (flag) {// 循环逻辑}六、函数标准书写格式函数是JS核心格式必须统一、整洁。普通函数规范// 函数功能简短注释function getUserName(userId) {return “用户” userId;}箭头函数规范复杂函数换行简单函数单行// 简单写法let add (a, b) a b;// 复杂写法换行let filterList (arr) {return arr.filter(item item 10);};七、注释书写规范注释不是越多越好关键逻辑必须注释基础代码不废话注释单行注释// 注释内容//后面加空格多行注释用于函数、模块说明✅ 规范示例// 获取用户列表数据function getUserList() {// 模拟接口请求return [];}八、完整规范 JS 代码模板可直接复用这是一套企业级标准JS书写模板新手写代码直接套这个格式九、新手最容易犯的格式错误汇总不写分号、缩进混乱乱用 var变量不规范if/for 省略大括号运算符前后不加空格代码拥挤所有代码堆在一起不分模块命名随便 a、b、c、temp、aaa十、规范总结记住这6句话全程统一缩进代码层层对齐语句必须带分号运算符前后空格常量用const变量用let禁止var命名小驼峰语义清晰不随意判断循环必加大括号不偷懒简写代码分区常量→变量→函数→业务逻辑写在最后代码的书写格式决定了你代码的下限。逻辑可以慢慢练但是格式必须从第一天就写标准。养成规范的JS书写习惯后续学习ES6、AJAX、Vue、React 都会事半功倍。
)
