Files
xk-doctor-wx/.cursor/rules/Code-Standards.md

1.4 KiB
Raw Blame History

description, alwaysApply
description alwaysApply
true
  1. 写代码的时候要补充详细的中文注释(每个方法是干嘛的,为什么要这样写),如果是工作区,则所有项目都适用该规则
  2. 注意不要生成太多的空行,上一部分代码和下一部分代码中间的空行不要大于2行
  3. 有封装好的方法、组件需要复用,不要重复造轮子
  4. 小程序端的抽屉全部需要用page-container来防止用户意外退出页面(记得使用v-if而不是v-show)
  5. 数据库的(created_at、updated_at、deleted_at)统一使用时间戳,不要使用字符串,并且我在查询器中一级格式化成字符串了,无需再次格式化
  6. 微信小程序 .vue 模板(会编译成 WXML)禁止使用 ??、?. 等现代运算符,否则会报 unexpected token '?';模板里用 || / 显式判断,脚本里可用 ??/?.
  7. 微信小程序模板里 :class / :style 禁止写 fn(arg) 方法调用(如 :class="sexClass(p)" 会编译失败);用对象/数组字面量(如 :class="{ male: p.sex == 1 }"),或把结果先算进 data/computed 再绑定
  8. 接口取值:写代码时先确认接口是 xk-api 还是 Yii,再固定用 code/result/message 或 errcode/data/msg(可用 unwrapXkApi / unwrapYiiApi);禁止运行时猜测、禁止 result || data(详见 Api-Response.mdc)