代码规范

​

核心原则

​

JavaScript 规范

​

文件头

/* ============================================================
 * 轻语博客 · 功能名称
 * ------------------------------------------------------------
 * 简要说明此文件的职责。
 * ============================================================ */

​

命名

​

缩进

​

兼容性

• 前端只使用浏览器原生 API（无 polyfill、无转译），因此 public/*.js 保持 ES5 风格写法（var / function），便于 file:// 直接预览
• 后端 functions/ 与 worker.js 运行在 Workers 运行时，可使用 ES Module 语法（import / export）

​

SQL 规范

• 新建表使用 CREATE TABLE IF NOT EXISTS
• 索引使用 CREATE INDEX IF NOT EXISTS
• 查询使用参数化绑定（db.prepare(sql).bind(...)），不拼接字符串
• SQLite 没有 ADD COLUMN IF NOT EXISTS：加列迁移无法幂等，必须在 .github/workflows/deploy.yml 的列预检 case 分支里登记「表名 + 列名」，详见迁移脚本
• 索引列顺序遵循 (等值过滤列 …, 排序列 …)，让 SQLite 免去临时排序；注意 SQLite 不允许把 rowid 用作索引列

​

CSS 规范

• CSS 变量定义主题色（明暗主题 × 4 种强调色：terra / indigo / bamboo / dusk）
• 响应式断点统一
• 新增重资源（播放器、背景动画等）不要在首屏关键路径加载

​

文档规范

​

Git 规范

feat(comments): add nested reply support

Implement parent_id field for comment threading.

Closes #42

​

测试

node smoke-test.js      # 冒烟测试 158 例
node gb-verify.js       # 留言板专项验证 18 例
node search-verify.js   # 搜索专项验证 25 例