前端代码规范

Front Standard Guide

前端 JS 项目开发规范

规范的目的是为了编写高质量的代码，让你的团队成员每天得心情都是愉悦的，大家在一起是快乐的。

引自《阿里规约》的开头片段：

----现代软件架构的复杂性需要协同开发完成，如何高效地协同呢？无规矩不成方圆，无规范难以协同，比如，制订交通法规表面上是要限制行车权，实际上是保障公众的人身安全，试想如果没有限速，没有红绿灯，谁还敢上路行驶。对软件来说，适当的规范和标准绝不是消灭代码内容的创造性、优雅性，而是限制过度个性化，以一种普遍认可的统一方式一起做事，提升协作效率，降低沟通成本。代码的字里行间流淌的是软件系统的血液，质量的提升是尽可能少踩坑，杜绝踩重复的坑，切实提升系统稳定性，码出质量。

一、编程规约

(一)命名规范

1.1.1 项目命名

全部采用小写方式，以中划线分隔。

正例：mall-management-system

反例：mall_management-system / mallManagementSystem

1.1.2 目录命名

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

正例： scripts / styles / components / images / utils / layouts / demo-styles / demo-scripts / img / doc

反例： script / style / demo_scripts / demoStyles / imgs / docs

【特殊】VUE 的项目中的 components 中的组件目录，使用 kebab-case 命名

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

反例： HeadSearch / PageLoading

【特殊】VUE 的项目中的除 components 组件目录外的所有目录也使用 kebab-case 命名
正例： page-one / shopping-car / user-management

反例： ShoppingCar / UserManagement

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

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

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

反例： renderDom.js / UserManagement.html

1.1.4 命名严谨性

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

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

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

杜绝完全不规范的缩写，避免望文不知义：

反例：AbstractClass“缩写”命名成 AbsClass；condition“缩写”命名成 condi，此类随意缩写严重降低了代码的可阅读性。

(二)HTML 规范（Vue Template 同样适用）

1.2.1 HTML 类型

推荐使用 HTML5 的文档类型申明： .
（建议使用 text/html 格式的 HTML。避免使用 XHTML。XHTML 以及它的属性，比如 application/xhtml+xml 在浏览器中的应用支持与优化空间都十分有限）。

规定字符编码
IE 兼容模式
规定字符编码
doctype 大写

正例：



  
    
    
    Page title

1.2.2 缩进

缩进使用 2 个空格（一个 tab）

嵌套的节点应该缩进。

1.2.3 分块注释

在每一个块状元素，列表元素和表格元素后，加上一对 HTML 注释。注释格式


### 1.2.4 语义化标签

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

正例


反例


#### 1.2.5 引号

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

正例： ``

反例： ``

### (三) CSS 规范

#### 1.3.1 命名

- 类名使用小写字母，以中划线分隔
- id 采用驼峰式命名
- scss 中的变量、函数、混合、placeholder 采用驼峰式命名

ID 和 class 的名称总是使用可以反应元素目的和用途的名称，或其他通用的名称，代替表象和晦涩难懂的名称

不推荐：

.fw-800 {
font-weight: 800;
}

.red {
color: red;
}


推荐:

.heavy {
font-weight: 800;
}

.important {
color: red;
}


#### 1.3.2 选择器

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

2)很多前端开发人员写选择器链的时候不使用 直接子选择器（注：直接子选择器和后代选择器的区别）。有时，这可能会导致疼痛的设计问题并且有时候可能会很耗性能。然而，在任何情况下，这是一个非常不好的做法。如果你不写很通用的，需要匹配到 DOM 末端的选择器， 你应该总是考虑直接子选择器。

不推荐:

.content .title {
font-size: 2rem;
}


推荐:

.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;
}


推荐：

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


#### 1.3.5 省略0后面的单位

不推荐：

div{
padding-bottom: 0px;
margin: 0em;
}


推荐：

div{
padding-bottom: 0;
margin: 0;
}


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

不推荐：

header{

padding-bottom: 0px;
margin: 0em;
}


推荐：

.header{
padding-bottom: 0px;
margin: 0em;
}


### (四) LESS 规范

#### 1.4.1 代码组织

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

例:// color.less,common.less

##### 2)按以下顺序组织

1、@import;
2、变量声明;
3、样式声明;

@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
}
}
}


推荐：

.main-title{
.name{
color:#fff
}
}


### (五) Javascript 规范

#### 1.5.1 命名

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

反例： `_name / name_ / name$`

##### 2) 方法名、参数名、成员变量、局部变量都统一使用 lowerCamelCase 风格，必须遵从驼峰形式。

正例： `localValue / getHttpMessage() / inputUserId`

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

正例：`saveShopCarData /openShopCarInfoDialog`

反例：`save / open / show / go`

****特此说明，增删查改，详情统一使用如下 5 个单词，不得使用其他（目的是为了统一各个端）\****

add / update / delete / detail / get


**附： 函数方法常用的动词:**

get 获取/set 设置,
add 增加/remove 删除
create 创建/destory 移除
start 启动/stop 停止
open 打开/close 关闭,
read 读取/write 写入
load 载入/save 保存,
create 创建/destroy 销毁
begin 开始/end 结束,
backup 备份/restore 恢复
import 导入/export 导出,
split 分割/merge 合并
inject 注入/extract 提取,
attach 附着/detach 脱离
bind 绑定/separate 分离,
view 查看/browse 浏览
edit 编辑/modify 修改,
select 选取/mark 标记
copy 复制/paste 粘贴,
undo 撤销/redo 重做
insert 插入/delete 移除,
add 加入/append 添加
clean 清理/clear 清除,
index 索引/sort 排序
find 查找/search 搜索,
increase 增加/decrease 减少
play 播放/pause 暂停,
launch 启动/run 运行
compile 编译/execute 执行,
debug 调试/trace 跟踪
observe 观察/listen 监听,
build 构建/publish 发布
input 输入/output 输出,
encode 编码/decode 解码
encrypt 加密/decrypt 解密,
compress 压缩/decompress 解压缩
pack 打包/unpack 解包,
parse 解析/emit 生成
connect 连接/disconnect 断开,
send 发送/receive 接收
download 下载/upload 上传,
refresh 刷新/synchronize 同步
update 更新/revert 复原,
lock 锁定/unlock 解锁
check out 签出/check in 签入,
submit 提交/commit 交付
push 推/pull 拉,
expand 展开/collapse 折叠
begin 起始/end 结束,
start 开始/finish 完成
enter 进入/exit 退出,
abort 放弃/quit 离开
obsolete 废弃/depreciate 废旧,
collect 收集/aggregate 聚集


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

正例： `MAX_STOCK_COUNT`

反例： `MAX_COUNT`

#### 1.5.2 代码格式

##### 1) 使用 2 个空格进行缩进

正例：

if (x < y) {
x += 10;
} else {
x += 1;
}


##### 2) 不同逻辑、不同语义、不同业务的代码之间插入一个空行分隔开来以提升可读性。

> 说明：任何情形，没有必要插入多个空行进行隔开。

#### 1.5.3 字符串

统一使用单引号(‘)，不使用双引号(“)。这在创建 HTML 字符串非常有好处：

正例:

let str = 'foo';
let testDiv = '


反例:

let str = 'foo';
let testDiv = "


#### 1.5.4 对象声明

##### 1)使用字面值创建对象

正例： `let user = {};`

反例： `let user = new Object();`

##### 2) 使用字面量来代替对象构造器

正例：

var user = {
age: 0,
name: 1,
city: 3
};


反例：

var user = new Object();
user.age = 0;
user.name = 0;
user.city = 0;


#### 1.5.5 使用 ES6,7

必须优先使用 ES6,7 中新增的语法糖和函数。这将简化你的程序，并让你的代码更加灵活和可复用。

> 必须强制使用 ES6, ES7 的新语法，比如箭头函数、await/async ， 解构， let ， for…of 等等

#### 1.5.6 括号

下列关键字后必须有大括号（即使代码块的内容只有一行）：if, else, for, while, do, switch, try, catch, finally, with。

正例：

if (condition) {
doSomething();
}


反例：

if (condition) doSomething();


#### 1.5.7 undefined 判断

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

正例：

if (typeof person === 'undefined') {
...
}


反例：

if (person === undefined) {
...
}


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

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

#### 1.5.9 this 的转换命名

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

#### 1.5.10 慎用 console.log

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

# 二、Vue 项目规范

### (一) Vue 编码基础

vue 项目规范以 Vue 官方规范 （https://cn.vuejs.org/v2/style-guide/） 中的 A 规范为基础，在其上面进行项目开发，故所有代码均遵守该规范。

> 请仔仔细细阅读 Vue 官方规范，切记，此为第一步。

#### 2.1.1. 组件规范

##### 1) 组件名为多个单词。

组件名应该始终是多个单词组成（大于等于 2），且命名规范为`KebabCase`格式。
这样做可以避免跟现有的以及未来的 HTML 元素相冲突，因为所有的 HTML 元素名称都是单个单词的。

正例：

export default {
name: 'TodoItem'
// ...
};


反例：

export default {
name: 'Todo',
// ...
}
export default {
name: 'todo-item',
// ...
}


##### 2) 组件文件名为 pascal-case 格式

正例：

components/
|- my-component.vue


反例：

components/
|- myComponent.vue
|- MyComponent.vue


##### 3) 基础组件文件名为 base 开头，使用完整单词而不是缩写。

正例：

components/
|- base-button.vue
|- base-table.vue
|- base-icon.vue


反例：

components/
|- MyButton.vue
|- VueTable.vue
|- Icon.vue


##### 4) 和父组件紧密耦合的子组件应该以父组件名作为前缀命名

正例：

components/
|- todo-list.vue
|- todo-list-item.vue
|- todo-list-item-button.vue
|- user-profile-options.vue （完整单词）


反例：

components/
|- TodoList.vue
|- TodoItem.vue
|- TodoButton.vue
|- UProfOpts.vue （使用了缩写）


##### 5) 在 Template 模版中使用组件，应使用 PascalCase 模式，并且使用自闭合组件。

正例：


反例：


##### 6) 组件的 data 必须是一个函数

当在组件中使用 data 属性的时候 (除了 new Vue 外的任何地方)，它的值必须是返回一个对象的函数。 因为如果直接是一个对象的话，子组件之间的属性值会互相影响。

正例：

export default {
data () {
return {
name: 'jack'
}
}
}


反例：

export default {
data: {
name: 'jack'
}
}


##### 7) Prop 定义应该尽量详细

- 必须使用 camelCase 驼峰命名
- 必须指定类型
- 必须加上注释，表明其含义
- 必须加上 required 或者 default，两者二选其一
- 如果有业务需要，必须加上 validator 验证

正例：

props: {
// 组件状态，用于控制组件的颜色
status: {
type: String,
required: true,
validator: function (value) {
return [
'succ',
'info',
'error'
].indexOf(value) !== -1
}
},
// 用户级别，用于显示皇冠个数
userLevel：{
type: String,
required: true
}
}


##### 8) 为组件样式设置作用域

正例：


反例：


##### 9) 如果特性元素较多，应该主动换行。

正例：

foo="a" bar="b" baz="c"
foo="a" bar="b" baz="c"
/>


反例：


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

组件模板应该只包含简单的表达式，复杂的表达式则应该重构为计算属性或方法。复杂表达式会让你的模板变得不那么声明式。我们应该尽量描述应该出现的是什么，而非如何计算那个值。而且计算属性和方法使得代码可以重用。

正例：

// 复杂表达式已经移入一个计算属性
computed: {
normalizedFullName: function () {
return this.fullName.split(' ').map(function (word) {
return word[0].toUpperCase() + word.slice(1)
}).join(' ')
}
}


反例：


#### 2.1.3 指令都使用缩写形式

指令推荐都使用缩写形式，(用 : 表示 v-bind: 、用 @ 表示 v-on: 和用 # 表示 v-slot:)

正例：

@input="onInput"
@focus="onFocus"


反例：

v-on:input="onInput"
@focus="onFocus"


#### 2.1.4 标签顺序保持一致

单文件组件应该总是让标签顺序保持为 `

正例：


反例：


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

#### 2.1.6 v-show 与 v-if 选择

如果运行时，需要非常频繁地切换，使用 v-show ；如果在运行时，条件很少改变，使用 v-if。

#### 2.1.7 script 标签内部结构顺序

components > props > data > computed > watch > filter > 钩子函数（钩子函数按其执行顺序） > methods

#### 2.1.8 Vue Router 规范

##### 1) 页面跳转数据传递使用路由参数

页面跳转，例如 A 页面跳转到 B 页面，需要将 A 页面的数据传递到 B 页面，推荐使用 路由参数进行传参，而不是将需要传递的数据保存 vuex，然后在 B 页面取出 vuex 的数据，因为如果在 B 页面刷新会导致 vuex 数据丢失，导致 B 页面无法正常显示数据。

正例：

let id = ' 123';
this.$router.push({ name: 'userCenter', query: { id: id } });


##### 2) 使用路由懒加载（延迟加载）机制

{
    path: '/uploadAttachment',
    name: 'uploadAttachment',
    meta: {
      title: '上传附件'
    },
    component: () => import('@/view/components/uploadAttachment/index.vue')
  },


##### 3) router 中的命名规范

path、childrenPoints 命名规范采用`kebab-case`命名规范（尽量vue文件的目录结构保持一致，因为目录、文件名都是`kebab-case`，这样很方便找到对应的文件）

name 命名规范采用`KebabCase`命名规范且和component组件名保持一致！（因为要保持keep-alive特性，keep-alive按照component的name进行缓存，所以两者必须高度保持一致）

// 动态加载
export const reload = [
{
path: '/reload',
name: 'reload',
component: Main,
meta: {
title: '动态加载',
icon: 'icon iconfont'
},

children: [
  {
    path: '/reload/smart-reload-list',
    name: 'SmartReloadList',
    meta: {
      title: 'SmartReload',
      childrenPoints: [
        {
          title: '查询',
          name: 'smart-reload-search'
        },
        {
          title: '执行reload',
          name: 'smart-reload-update'
        },
        {
          title: '查看执行结果',
          name: 'smart-reload-result'
        }
      ]
    },
    component: () =>
      import('@/views/reload/smart-reload/smart-reload-list.vue')
  }
]

}
];


##### 4) router 中的 path 命名规范

path除了采用`kebab-case`命名规范以外，必须以 / 开头，即使是children里的path也要以 / 开头。如下示例

- 

目的：

经常有这样的场景：某个页面有问题，要立刻找到这个vue文件，如果不用以/开头，path为parent和children组成的，可能经常需要在router文件里搜索多次才能找到，而如果以/开头，则能立刻搜索到对应的组件
*

{
path: '/file',
name: 'File',
component: Main,
meta: {
title: '文件服务',
icon: 'ios-cloud-upload'
},
children: [
{
path: '/file/file-list',
name: 'FileList',
component: () => import('@/views/file/file-list.vue')
},
{
path: '/file/file-add',
name: 'FileAdd',
component: () => import('@/views/file/file-add.vue')
},
{
path: '/file/file-update',
name: 'FileUpdate',
component: () => import('@/views/file/file-update.vue')
}
]
}


### (二) Vue 项目目录规范

#### 2.2.1 基础

vue 项目中的所有命名一定要与后端命名统一。

比如权限：后端 privilege, 前端无论 router , store, api 等都必须使用 privielege 单词！

#### 2.2.2 使用 Vue-cli 脚手架

使用 vue-cli3 来初始化项目，项目名按照上面的命名规范。

#### 2.2.3 目录说明

目录名按照上面的命名规范，其中 components 组件用大写驼峰，其余除 components 组件目录外的所有目录均使用 kebab-case 命名。


##### 1) api 目录

- 文件、变量命名要与后端保持一致。
- 此目录对应后端 API 接口，按照后端一个 controller 一个 api js 文件。若项目较大时，可以按照业务划分子目录，并与后端保持一致。
- api 中的方法名字要与后端 api url 尽量保持语义高度一致性。
- 对于 api 中的每个方法要添加注释，注释与后端 swagger 文档保持一致。

正例：

后端 url： EmployeeController.java

/employee/add
/employee/delete/{id}
/employee/update


前端： employee.js

// 添加员工
addEmployee: (data) => {
return postAxios('/employee/add', data)
},
// 更新员工信息
updateEmployee: (data) => {
return postAxios('/employee/update', data)
},
// 删除员工
deleteEmployee: (employeeId) => {
return postAxios('/employee/delete/' + employeeId)
},


##### 2) assets 目录

assets 为静态资源，里面存放 images, styles, icons 等静态资源，静态资源命名格式为 kebab-case


##### 3) components 目录

此目录应按照组件进行目录划分，目录命名为 KebabCase，组件命名规则也为 KebabCase


##### 4) constants 目录

此目录存放项目所有常量，如果常量在 vue 中使用，请使用 vue-enum 插件(https://www.npmjs.com/package/vue-enum)

目录结构：

|constants
|-- index.js
|-- role.js
|-- employee.js


例子： employee.js

export const EMPLOYEE_STATUS = {
NORMAL: {
value: 1,
desc: '正常'
},
DISABLED: {
value: 1,
desc: '禁用'
},
DELETED: {
value: 2,
desc: '已删除'
}
};

export const EMPLOYEE_ACCOUNT_TYPE = {
QQ: {
value: 1,
desc: 'QQ登录'
},
WECHAT: {
value: 2,
desc: '微信登录'
},
DINGDING: {
value: 3,
desc: '钉钉登录'
},
USERNAME: {
value: 4,
desc: '用户名密码登录'
}
};

export default {
EMPLOYEE_STATUS,
EMPLOYEE_ACCOUNT_TYPE
};


##### 5) router 与 store 目录

这两个目录一定要将业务进行拆分，不能放到一个 js 文件里。

router 尽量按照 views 中的结构保持一致

store 按照业务进行拆分不同的 js 文件

##### 6) views 目录

- 命名要与后端、router、api 等保持一致
- components 中组件要使用 PascalCase 规则


#### 2.2.4 注释说明

整理必须加注释的地方

- 公共组件使用说明
- api 目录的接口 js 文件必须加注释
- store 中的 state, mutation, action 等必须加注释
- vue 文件中的 template 必须加注释，若文件较大添加 start end 注释
- vue 文件的 methods，每个 method 必须添加注释
- vue 文件的 data, 非常见单词要加注释

#### 2.2.5 其他

##### 1) 尽量不要手动操作 DOM

因使用 vue 框架，所以在项目开发中尽量使用 vue 的数据驱动更新 DOM，尽量（不到万不得已）不要手动操作 DOM，包括：增删改 dom 元素、以及更改样式、添加事件等。

##### 2) 删除无用代码

因使用了 git/svn 等代码版本工具，对于无用代码必须及时删除，例如：一些调试的 console 语句、无用的弃用功能代码。

你可能感兴趣的:(开发规范)

JavaScript 中 xml 的解析（dom4j 解析器），web前端开发规范手册 2401_84094868 程序员前端 javascript xml
创建元素：Elementschool=DocumentHelper.createElement(“school”);创建文本：school.addText(“光明小学”);指定位置添加：list.add(1,school);回写xml：和在末尾添加一样7、获取属性值attributeValue()：获取属性值publicstaticvoidmain(String[]args)throwsDocum
设计之道：ORM、DAO、Service与三层架构的规范探索 VaporGas Java后端重构 java 设计规范 ORM DAO Service 三层架构
引言：实际开发中，遵守一定的开发规范，不仅可以提高开发效率，还可以提高项目的后续维护性以及项目的扩展性；了解一下本博客的项目设计规范，对项目开发很有意义一、ORM思想ORM（Object-Relational-Mapping）在对象模型和关系型模型之间做一个映射（转换）。目的是为了解决面向对象编程语言的发展和关系型数据库的发展不匹配的问题可以理解为：将Java中的数据结构与MySQL数据库中的数据
JavaBean 我是邱邱
开发规范，可以说是一种技术。javaBean就是一个普通的java类，但必须满足以下条件才能够称为是JavaBean：1）必须提供无参的构造方法；2）类中属性必须私有化；3）该类提供公共的getter和setter方法。JavaBean的使用场景：1）项目中用到的实体对象2）EL表达式中用到的访问对象的属性3）jsp标签张的属性赋值jsp中创建对象以及给对象属性赋值以及获取属性值的usebean也
多层条件语句重构 BIGSHU0923 设计模式重构
概述阿里的java开发规范中建议：多层条件语句建议使用卫语句、策略模式、状态模式等方式重构。卫语句卫语句（GuardClauses）是一种编程实践，用于简化方法中的条件逻辑，使代码更清晰、更易读。它通过在方法的开头直接处理特殊情况或异常情况，并在满足条件时立即返回，从而避免嵌套的条件语句。使用卫语句的好处包括：减少嵌套，代码更平坦，更易读。提前处理异常情况，使主要逻辑更清晰。改善代码维护性。卫语句
单元测试编写 BIGSHU0923 单元测试 log4j
概述记录，为了快速查找。用JUnit5和Mockito。参考阿里的java开发规范，单元测试主要遵循AIR原则，即自动化(Automation)、独立性(Independence)、可重复性(Repeatability)。单测的基本目标：语句覆盖率达到70%；核心模块的语句覆盖率和分支覆盖率都要达到100%。（Jacoco)编写单元测试代码遵守BCDE原则，以保证被测试模块的交付质量。⚫B：Bor
HarmonyOS开发规范：JSVM-API接口总结冲浪王子_浪浪 HarmonyOS OpenHarmony 鸿蒙开发前端鸿蒙华为 harmonyos html 移动开发鸿蒙系统
JSVM_Status是一个枚举数据类型，表示JSVM-API接口返回的状态信息。每当调用一个JSVM-API函数，都会返回该值，表示操作成功与否的相关信息。typedefenum{JSVM_OK,JSVM_INVALID_ARG,JSVM_OBJECT_EXPECTED,JSVM_STRING_EXPECTED,JSVM_NAME_EXPECTED,JSVM_FUNCTION_EXPECTED,
鸿蒙HarmonyOS开发规范-完善中小白学鸿蒙 HarmonyOS开发者百宝箱 HarmonyOS从入门到头秃鸿蒙开发杂谈 harmonyos 华为鸿蒙鸿蒙系统
代码规范所有文件，包括自动生成的编译文件package.json都要格式化（IDE快捷键Ctrl+Alt+L）；函数命名，C++大驼峰，TS、JS小驼峰，函数命名注意动宾结构；静态常量需使用全大写，文件目录使用全小写（不建议包含特殊字符如"-“和”_"等）；类名使用大驼峰，函数的参数、全局变量和局部变量都使用小驼峰，命名要规范化，见名知意；if语句后必须跟“{”，哪怕只有一行代码；有break或r
GoFly快速开发后台框架代码开发规范 GoFly开发者 Go语言 GoFly快速开发框架开发规范 go
在开发中代码开发时建议大家按照打包要求去开发项目，这样可以确保新开发代码可以打包成插件，如果你开发项目确定不会打包那就不需要按规范开发了，只需保证你业务代码跑起来就行。这里我们要求是为了开发后的功能可以打包成代码仓的插件，方便后期复用。一、创建文件目录要求在app目录下创建的模块目录下要有controller.go，用controller.go控制器引入类目录模块目录目录下必须是目录文件夹，不能直
大客户项目管理策略思考 guwei666666 项目实施大数据
笔者今天给大家带来一些实施思考，思路如下：大客户的定义：合作期限长，涉及客户业务广泛，积累的系统多，和客户的黏性大大客户项目面临的问题：业务范围广，系统多，建设初期没有规划，存在孤岛，都是根据工作实际内容缺乏信息化总体规划，项目开发建设存在突击性，部分项目时间要求短，属于突击需求大客户面临的问题-自己：1、项目建设时间短，质量不高，项目间各自独立开发，重复开发，复用率低，开发规范差，后期运维压力大
Hive SQL 开发指南（三）优化及常见异常大数据_苡~ 003-数据开发 hive Hive优化数据倾斜 Hive常见异常 hive join
在大数据领域，HiveSQL是一种常用的查询语言，用于在Hadoop上进行数据分析和处理。为了确保代码的可读性、维护性和性能，制定一套规范化的HiveSQL开发规范至关重要。本文将介绍HiveSQL的基础知识，并提供一些规范化的开发指南，帮助您高效地编写HiveSQL查询。本系列分为HiveSQL开发指南（一）数据类型及函数HiveSQL开发指南（二）使用（DDL、DML，DQL）HiveSQL开
smart-backend-standard-guide前端代码规范 ʚ梅梅ɞ vue 前端 javascript vue.js
前端JS项目开发规范规范的目的是为了编写高质量的代码，让你的团队成员每天得心情都是愉悦的，大家在一起是快乐的。引自《阿里规约》的开头片段：----现代软件架构的复杂性需要协同开发完成，如何高效地协同呢？无规矩不成方圆，无规范难以协同，比如，制订交通法规表面上是要限制行车权，实际上是保障公众的人身安全，试想如果没有限速，没有红绿灯，谁还敢上路行驶。对软件来说，适当的规范和标准绝不是消灭代码内容的创造
Day01 javaweb开发——tlias员工管理系统临渊羡鱼的猫 spring boot
任务介绍完成部门管理和员工管理的增删改查功能环境搭建前端---->后端---->数据库准备数据库表创建springboot工程（web、mybatis、mysql驱动、lombok）application.properties中引入mybatis配置信息，准备对应的实体类准备三层架构标准代码（controller基础结构、service接口、实现类、mapper）restful开发规范通过URL定
VUE开发规范 GaoJamie #Vue.js vue.js 前端 javascript
VUE开发规范（仅作参考）编程规约命名规范项目命名全部采用小写方式，以中划线分隔。正例：mall-management-system反例：mall_management-system/mallManagementSystem目录命名全部采用小写方式，以中划线分隔，有复数结构时，要采用复数命名法，缩写不用复数正例：scripts/styles/components/images/utils/layo
Go——使用Goland创建并运行一个go项目火山彬 go语言学习
创建项目创建项目的时候注意选择好使用的Go版本。一、创建目录为了遵循Google的Go的开发规范，和方便我们之后的工作，我们按照Go的要求，在每个项目文件夹下建立三个文件夹:bin/生成的执行文件pkg/编译的中间文件src/程序的代码文件二、设置环境点击打开项目配置，配置Go的使用环境，同样，遵循Google的开发建议，每个项目都建立自己独有的PATH.如下图：GlobalGOPATH添加放置G
（转载）阿里云Redis开发规范 dbc94a66f502
https://yq.aliyun.com/articles/531067?spm=a2c4e.11153940.0.0.771d7616DEKWRC一、键值设计1.key名设计(1)【建议】:可读性和可管理性以业务名(或数据库名)为前缀(防止key冲突)，用冒号分隔，比如业务名:表名:idugc:video:1(2)【建议】：简洁性保证语义的前提下，控制key的长度，当key较多时，内存占用也不
阿里巴巴Android开发手册下载 Air_w
春意盎然之际，阿里巴巴再度为工程师送上一份重磅开春好礼：《阿里巴巴Android开发手册》。该开发规范在阿里内部经过了长期的修缮，现已总结成册，向所有移动开发者、技术爱好者开放，希望帮助开发者码出高效、码出质量，提升系统的质量、协作的高效性。封面图目录附上链接点击下载Android开发手册
前端架构之路（3） - 前端开发规范 senntyou
前端开发规范1.为什么需要“前端开发规范”规范不是强制性的，对代码的编写和程序的运行不会有致命的问题，但是没有规范会有一系列的问题，比如：缺乏规范，第一个问题就是团队编码风格不一，增加了成员之间代码的阅读成本，加大了团队协作成本和维护成本；随着团队人员的变化（多人开发一个应用，或者应用更换开发人员），如果缺乏规范，项目可能会变得一团糟，甚至失控；即便是个人开发，规范也是需要的，当把项目转给其他人的
内置模块和开发规范李小狗儿 python全栈数据库服务器运维 python 快速入门
内置模块和开发规范1.内置模块1.1json1.1.1核心功能练习题1.1.2类型要求1.1.3其他功能1.2时间处理1.2.1time1.2.2datetime练习题1.3正则表达式相关1.3.1正则表达式1.字符相关2.数量相关3.括号（分组）练习题4.起始和结束5.特殊字符1.3.2re模块小结2.项目开发规范2.1单文件应用2.2单可执行文件2.3多可执行文件总结作业：开发短视频资讯平台附
数仓建设规范长不大的大灰狼大数据数据仓库大数据
数仓建设规范一、数据模型架构原则1.数仓分层原则2.主题域划分原则3.数据模型设计原则二、数仓公共开发规范1.层次调用规范2.数据类型规范3.数据冗余规范4.NULL字段处理规范5.指标口径规范6.数据表处理规范四、数仓命名规范1.词根设计规范一、数据模型架构原则1.数仓分层原则一个好的分层架构，要有以下好处：清晰数据结构；数据血缘追踪；减少重复开发；数据关系条理化；屏蔽原始数据的影响。数仓分层要
数据结构设计与开发规范勤_
表设计规范对象名称必须使用小写，多单词统一使用下划线分割所有的表设计统一命名规范，主表用t_e_开头，关系表用t_con_开头，统计表用t_as_开头，例如plan_project换成t_e_plan_project，这样能见名知意理解作用。临时表必须以tmp_开头、以日期结尾，备份表必须以bak_开头、以日期结尾数据库和数据表统一使用UTF8MB4字符编码所有的表和字段必须添加注释表列保证在20
了解MySQL 开发规范 tot_lbr mysql 性能优化数据库
了解MySQL开发规范尽量避免在数据库做运算，复杂运算应移至业务应用层数据库的主要职责是存储和管理数据，而不是执行复杂的计算。尤其是涉及到大量数据时，数据库的负荷会变得沉重，影响系统性能。将复杂运算移到业务应用层，有助于分担数据库的压力。优化影响性能的SQMyL语句通过监控慢查询日志，找到对系统性能影响较大的SQL语句进行优化。可以选择优化频繁执行的语句，或者优化后带来最明显性能提升的语句。这有助
前端开发规范V2023.5 一枚攻城狮前端前端开发规范
前端开发规范本文档适用于所有前端项目的开发，为了方便开发团队和个人统一规范风格而作。文档中包含了开发中需要注意的事项以及参考建议，本文档不单是一篇规范要求，同时也是前端开发手册，当你不知如何做比较好的时候，请参考本文档中推荐的建议来开发。一、命名规范1.项目命名全部采用kebab-case命名，字母小写，以短横分隔单词。正例：my-project-name反例：my_project_name/my
【阿里开发规范】Java开发手册（嵩山版）无名· java
Java开发手册（嵩山版）所有的POJO类属性必须使用包装数据类型构造方法里面禁止加入任何业务逻辑，如果有初始化逻辑，请放到init方法中类成员与方法访问控制从严：(1)类成员方法只对继承类公开，那么限制为protected(2)若是static成员变量，考虑是否为final说明：任何类，方法，参数，变量，严格控制访问范围。过于宽泛的访问范围，不利于模块解耦。思考：如果是一个private的方法，
代码分析体系及Sonarqube平台霍格沃兹测试开发学社
代码分析综合性的代码分析平台：sonar支持自定义规则,较多的公司使用IDE辅助功能：xcode、androidstudio独立的静态分析工具：findbugs、androidlint、scan-build、pmd、阿里巴巴java开发规范pmd插件image.png代码审计关注的质量指标代码坏味道：代码规范、技术债评估代码重复度、圈复杂度bug和漏洞单元测试规模覆盖率分析代码静态检查代码语法分析
在线教育后端开发项目总结 MONA ODYSSEY Java开发后端 java spring boot mvc
文章目录一数据库访问接口1MyBatis2SpringDataJPA3SpringDataMongoDB二数据库1MySQL2MongoDB3Redis三开发规范化、响应格式与异常处理1开发规范2响应格式3异常处理四RabbitMQ五SpringCloud相关工具1Eureka2Ribbon3Feign4Zuul网关六搜索服务1ElasticSearch2Logstash七用户认证与授权1Spri
鸿蒙开发【应用开发基础知识】移不动开发技术鸿蒙开发 harmonyos 华为鸿蒙开发程序员鸿蒙系统 openharmony 鸿蒙星空版
应用开发介绍1.项目说明通过OpenHarmony提供的Stage模型和ArkUI的eTS声明式开发规范，结合简单的Demo，分享学习OpenHarmony/docs/application-dev[应用开发文档]2.主要功能目录标题展示，目录列表展示点击目录列表，查看列表内容点击目录标题的返回箭头，返回之前的内容页面内容溢出，可上下滑动查看内容3.效果展示4.开发环境搭建首先需要搭建好开发环境。
知识点积累系列（九）开发规范篇【持续更新】格桑阿sir 云原生学习专栏 kubernetes 容器云原生 golang devops 代码规范
云原生学习路线导航页（持续更新中）本文是知识点积累系列文章的第九篇，记录日常学习中遇到的开发规范相关的知识点1.OpenAPI是什么，和swagger有什么区别OpenAPI：其实就是用于描述应用API信息的通用规范，让其他人不需要看你的代码，就知道你这个API接口在做什么、怎么使用OpenAPI概念的博客：https://apifox.com/apiskills/what-is-openapi/
面试官告诉你：大数据究竟该怎么学语兴数据大数据程序人生面试实习产出大数据学习
如何提高自己的实习期产出，快速在实习期有表现？语兴回答先熟悉业务可以跟mentor沟通也可以找下游业务去问，也可以从app使用中理解，如果觉得还是慢，就直接看dwd数据表去快速了解。开发流程也要了解，包括平台使用和开发规范等。以上内容做完去尝试做一些添加字段需求，结合12更好了解业务和表结构。实习生没啥产出，能做的更多是简单数据域模型，加字段，任务调优等，将mentor布置的活干完就行，再到转正前
iOS泛型 Jorunk
泛型：限制类型开发中使用场景：限制集合中的类型,注意:只能检测方法的调用，因为声明的泛型，只能放在方法中当一个类在声明的时候，某个对象的属性不确定,只有创建对象的时候才确定,可以使用泛型泛型书写格式:放在类型后面，表示限制这个类型.好处:提高程序员开发规范，减少交流成本。从数组或者字典取值，都是id类型，不能调用点语法，但是使用泛型，就可以了。自定义泛型:模仿数组需求：假设有个Person,这个人
数据库--学习记录进击的小白9527 数据库服务器运维
1.MySQL引入1.1软件目录开发规范"""------流行蝴蝶剑—------conf:这个项目的配置文件-core:核心逻辑；-lib：公共的方法；log:日志；-bin:放置启动文件-db:程序运行过程中产生的一些数据readme.md:程序说明书“”“1.2数据库引入要将单机游戏，转变成为联网游戏，就是需要一个服务端存数所有客户端共有的数据部分，被称为数据库或是数据服务端。而这些向数据库
Java常用排序算法/程序员必须掌握的8大排序算法 cugfy java
分类： 1）插入排序（直接插入排序、希尔排序） 2）交换排序（冒泡排序、快速排序） 3）选择排序（直接选择排序、堆排序） 4）归并排序 5）分配排序（基数排序）所需辅助空间最多：归并排序所需辅助空间最少：堆排序平均速度最快：快速排序不稳定：快速排序，希尔排序，堆排序。先来看看8种排序之间的关系： 1.直接插入排序（1
【Spark102】Spark存储模块BlockManager剖析 bit1129 manager
Spark围绕着BlockManager构建了存储模块，包括RDD，Shuffle，Broadcast的存储都使用了BlockManager。而BlockManager在实现上是一个针对每个应用的Master/Executor结构，即Driver上BlockManager充当了Master角色，而各个Slave上(具体到应用范围，就是Executor)的BlockManager充当了Slave角色
linux 查看端口被占用情况详解 daizj linux 端口占用 netstat lsof
经常在启动一个程序会碰到端口被占用，这里讲一下怎么查看端口是否被占用，及哪个程序占用，怎么Kill掉已占用端口的程序 1、lsof -i:port port为端口号 [root@slave /data/spark-1.4.0-bin-cdh4]# lsof -i:8080 COMMAND PID USER FD TY
Hosts文件使用周凡杨 hosts locahost
一切都要从localhost说起，经常在tomcat容器起动后，访问页面时输入http://localhost:8088/index.jsp，大家都知道localhost代表本机地址，如果本机IP是10.10.134.21，那就相当于http://10.10.134.21:8088/index.jsp，有时候也会看到http: 127.0.0.1:
java excel工具 g21121 Java excel
直接上代码，一看就懂，利用的是jxl： import java.io.File; import java.io.IOException; import jxl.Cell; import jxl.Sheet; import jxl.Workbook; import jxl.read.biff.BiffException; import jxl.write.Label; import
web报表工具finereport常用函数的用法总结（数组函数）老A不折腾 finereport web报表函数总结
ADD2ARRAY ADDARRAY(array,insertArray, start):在数组第start个位置插入insertArray中的所有元素，再返回该数组。示例： ADDARRAY([3,4, 1, 5, 7], [23, 43, 22], 3)返回[3, 4, 23, 43, 22, 1, 5, 7]. ADDARRAY([3,4, 1, 5, 7], "测试&q
游戏服务器网络带宽负载计算墙头上一根草服务器
家庭所安装的4M，8M宽带。其中M是指，Mbits/S 其中要提前说明的是： 8bits = 1Byte 即8位等于1字节。我们硬盘大小50G。意思是50*1024M字节，约为 50000多字节。但是网宽是以“位”为单位的，所以，8Mbits就是1M字节。是容积体积的单位。 8Mbits/s后面的S是秒。8Mbits/s意思是每秒8M位，即每秒1M字节。我是在计算我们网络流量时想到的
我的spring学习笔记2-IoC（反向控制依赖注入） aijuans Spring 3 系列
IoC（反向控制依赖注入）这是Spring提出来了，这也是Spring一大特色。这里我不用多说，我们看Spring教程就可以了解。当然我们不用Spring也可以用IoC，下面我将介绍不用Spring的IoC。 IoC不是框架，她是java的技术，如今大多数轻量级的容器都会用到IoC技术。这里我就用一个例子来说明：如：程序中有 Mysql.calss 、Oracle.class 、SqlSe
高性能mysql 之选择存储引擎(一) annan211 mysql InnoDB MySQL引擎存储引擎
1 没有特殊情况，应尽可能使用InnoDB存储引擎。原因：InnoDB 和 MYIsAM 是mysql 最常用、使用最普遍的存储引擎。其中InnoDB是最重要、最广泛的存储引擎。她被设计用来处理大量的短期事务。短期事务大部分情况下是正常提交的，很少有回滚的情况。InnoDB的性能和自动崩溃恢复特性使得她在非事务型存储的需求中也非常流行，除非有非常
UDP网络编程百合不是茶 UDP编程局域网组播
UDP是基于无连接的,不可靠的传输与TCP/IP相反 UDP实现私聊,发送方式客户端,接受方式服务器 package netUDP_sc; import java.net.DatagramPacket; import java.net.DatagramSocket; import java.net.Ine
JQuery对象的val()方法执行结果分析 bijian1013 JavaScript js jquery
JavaScript中，如果id对应的标签不存在（同理JAVA中，如果对象不存在），则调用它的方法会报错或抛异常。在实际开发中，发现JQuery在id对应的标签不存在时，调其val()方法不会报错，结果是undefined。
http请求测试实例（采用json-lib解析） bijian1013 json http
由于fastjson只支持JDK1.5版本，因些对于JDK1.4的项目，可以采用json-lib来解析JSON数据。如下是http请求的另外一种写法，仅供参考。 package com; import java.util.HashMap; import java.util.Map; import
【RPC框架Hessian四】Hessian与Spring集成 bit1129 hessian
在【RPC框架Hessian二】Hessian 对象序列化和反序列化一文中介绍了基于Hessian的RPC服务的实现步骤，在那里使用Hessian提供的API完成基于Hessian的RPC服务开发和客户端调用，本文使用Spring对Hessian的集成来实现Hessian的RPC调用。定义模型、接口和服务器端代码 |---Model &nb
【Mahout三】基于Mahout CBayes算法的20newsgroup流程分析 bit1129 Mahout
1.Mahout环境搭建 1.下载Mahout http://mirror.bit.edu.cn/apache/mahout/0.10.0/mahout-distribution-0.10.0.tar.gz 2.解压Mahout 3. 配置环境变量 vim /etc/profile export HADOOP_HOME=/home
nginx负载tomcat遇非80时的转发问题 ronin47
　　nginx负载后端容器是tomcat（其它容器如WAS,JBOSS暂没发现这个问题）非８０端口，遇到跳转异常问题。解决的思路是：$host:port 详细如下：　　该问题是最先发现的，由于之前对nginx不是特别的熟悉所以该问题是个入门级别的： ? 1 2 3 4 5
java-17-在一个字符串中找到第一个只出现一次的字符 bylijinnan java
public class FirstShowOnlyOnceElement { /**Q17.在一个字符串中找到第一个只出现一次的字符。如输入abaccdeff，则输出b * 1.int[] count:count[i]表示i对应字符出现的次数 * 2.将26个英文字母映射：a-z <--> 0-25 * 3.假设全部字母都是小写 */ pu
mongoDB 复制集开窍的石头 mongodb
mongo的复制集就像mysql的主从数据库，当你往其中的主复制集(primary)写数据的时候，副复制集(secondary)会自动同步主复制集(Primary)的数据,当主复制集挂掉以后其中的一个副复制集会自动成为主复制集。提供服务器的可用性。和防止当机问题 mo
[宇宙与天文]宇宙时代的经济学 comsci 经济
宇宙尺度的交通工具一般都体型巨大，造价高昂。。。。。在宇宙中进行航行，近程采用反作用力类型的发动机，需要消耗少量矿石燃料，中远程航行要采用量子或者聚变反应堆发动机，进行超空间跳跃，要消耗大量高纯度水晶体能源以目前地球上国家的经济发展水平来讲，
Git忽略文件 Cwind git
有很多文件不必使用git管理。例如Eclipse或其他IDE生成的项目文件，编译生成的各种目标或临时文件等。使用git status时，会在Untracked files里面看到这些文件列表，在一次需要添加的文件比较多时（使用git add . / git add -u），会把这些所有的未跟踪文件添加进索引。 ==== ==== ==== 一些牢骚
MySQL连接数据库的必须配置 dashuaifu mysql 连接数据库配置
MySQL连接数据库的必须配置 1.driverClass：com.mysql.jdbc.Driver 2.jdbcUrl：jdbc:mysql://localhost:3306/dbname 3.user：username 4.password：password 其中1是驱动名；2是url，这里的‘dbna
一生要养成的60个习惯 dcj3sjt126com 习惯
一生要养成的60个习惯第1篇让你更受大家欢迎的习惯 1 守时，不准时赴约,让别人等,会失去很多机会。如何做到： ①该起床时就起床， ②养成任何事情都提前15分钟的习惯。 ③带本可以随时阅读的书，如果早了就拿出来读读。 ④有条理，生活没条理最容易耽误时间。 ⑤提前计划：将重要和不重要的事情岔开。 ⑥今天就准备好明天要穿的衣服。 ⑦按时睡觉，这会让按时起床更容易。 2 注重
[介绍]Yii 是什么 dcj3sjt126com PHP yii2
Yii 是一个高性能，基于组件的 PHP 框架，用于快速开发现代 Web 应用程序。名字 Yii （读作易）在中文里有“极致简单与不断演变”两重含义，也可看作 Yes It Is! 的缩写。 Yii 最适合做什么？ Yii 是一个通用的 Web 编程框架，即可以用于开发各种用 PHP 构建的 Web 应用。因为基于组件的框架结构和设计精巧的缓存支持，它特别适合开发大型应
Linux SSH常用总结 eksliang linux ssh SSHD
转载请出自出处：http://eksliang.iteye.com/blog/2186931 一、连接到远程主机格式： ssh name@remoteserver 例如： ssh [email protected] 二、连接到远程主机指定的端口格式： ssh name@remoteserver -p 22 例如： ssh i
快速上传头像到服务端工具类FaceUtil gundumw100 android
快速迭代用 import java.io.DataOutputStream; import java.io.File; import java.io.FileInputStream; import java.io.FileNotFoundException; import java.io.FileOutputStream; import java.io.IOExceptio
jQuery入门之怎么使用 ini JavaScript html jquery Web css
jQuery的强大我何问起（个人主页：hovertree.com）就不用多说了，那么怎么使用jQuery呢？首先，下载jquery。下载地址：http://hovertree.com/hvtart/bjae/b8627323101a4994.htm，一个是压缩版本，一个是未压缩版本，如果在开发测试阶段，可以使用未压缩版本，实际应用一般使用压缩版本(min)。然后就在页面上引用。
带filter的hbase查询优化 kane_xie 查询优化 hbase RandomRowFilter
问题描述 hbase scan数据缓慢，server端出现LeaseException。hbase写入缓慢。问题原因直接原因是： hbase client端每次和regionserver交互的时候，都会在服务器端生成一个Lease,Lease的有效期由参数hbase.regionserver.lease.period确定。如果hbase scan需
java设计模式-单例模式 men4661273 java 单例枚举反射 IOC
单例模式1，饿汉模式 //饿汉式单例类.在类初始化时，已经自行实例化 public class Singleton1 { //私有的默认构造函数 private Singleton1() {} //已经自行实例化 private static final Singleton1 singl
mongodb 查询某一天所有信息的3种方法，根据日期查询 qiaolevip 每天进步一点点学习永无止境 mongodb 纵观千象
// mongodb的查询真让人难以琢磨，就查询单天信息，都需要花费一番功夫才行。 // 第一种方式： coll.aggregate([ {$project:{sendDate: {$substr: ['$sendTime', 0, 10]}, sendTime: 1, content:1}}, {$match:{sendDate: '2015-
二维数组转换成JSON tangqi609567707 java 二维数组 json
原文出处：http://blog.csdn.net/springsen/article/details/7833596 public class Demo { public static void main(String[] args) { String[][] blogL
erlang supervisor wudixiaotie erlang
定义supervisor时，如果是监控celuesimple_one_for_one则删除children的时候就用supervisor:terminate_child (SupModuleName, ChildPid)，如果shutdown策略选择的是brutal_kill，那么supervisor会调用exit(ChildPid, kill)，这样的话如果Child的behavior是gen_

按字母分类： A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 其他

开发规范