| 术语 | 通俗解释 | 本项目例子 |
|---|---|---|
| 项目根目录 | 放着整套工程入口的文件夹 | D:\xiaolanshu-go |
| 终端 / PowerShell | 通过文字向电脑发命令的窗口 | 运行 go test ./... |
| 进程 | 一个正在运行的程序 | Go 服务启动后占用一个进程 |
| 端口 | 同一台电脑上区分网络服务的号码 | 8080 是后端,5173 是 Vite |
| 前端 | 浏览器执行、显示给人的程序 | React 组件和 CSS |
| 后端 | 接受请求、验证身份、执行规则的程序 | cmd/server/main.go 启动的 Go 服务 |
| HTTP | 浏览器与后端交换请求和响应的约定 | POST 登录、GET 图片 |
| API / 接口 | 后端对外暴露的某个操作入口 | /api/note/note/publish |
| JSON | 一种能表示对象和数组的文本格式 | {"title":"周末"} |
| 数据库 | 按规则保存和查询数据的程序/文件 | SQLite 的 .db 文件 |
| SQL | 与关系数据库交流的语言 | SELECT、INSERT、UPDATE |
| 表 / 行 / 列 | 数据分类、单条记录、每条的字段 | users 表一行代表一个用户 |
| 主键 | 一行记录的唯一身份 | users.id |
| 外键 | 指向另一张表中确实存在的记录 | notes.creator_id 指向 users.id |
| 唯一约束 | 数据库保证某种组合不重复 | 同用户同笔记只能有一个赞 |
| 事务 | 一组操作全部成功或全部不生效 | 改密码和注销其他设备会话 |
| 幂等 | 同一动作重复执行不产生额外结果 | 重复点赞仍只计一次 |
| 持久化 | 程序退出后数据仍然存在 | 发布后重启仍能查到笔记 |
| 鉴权 | 判断你是谁、能不能做此动作 | 修改笔记必须是作者 |
| JWT | 带签名的身份声明文本 | Authorization 请求头中的 token |
| 会话 | 服务器保存的一次登录记录 | sessions 表的 jti |
| 哈希 | 把输入变成不能直接还原的摘要 | bcrypt 保存密码,而非明文 |
| 中间件 | 位于业务之前/之后的通用处理 | 安全响应头、限流、超时 |
| 依赖 | 项目引用的别人写好的代码 | SQLite 驱动、React |
| 锁文件 | 记录这次实际安装的精确版本 | package-lock.json、go.sum |
| 构建 / 编译 | 把源码变成可运行或可发布的产物 | .exe、frontend/dist |
| 单实例 | 只有一个后端进程负责这套数据 | 默认 SQLite 部署方式 |
| 单元 / 集成测试 | 单块规则 / 多块一起验证 | httptest → service → 临时 SQLite |
| 回归测试 | 改动之后检查以前正常的功能 | 升级依赖后重跑登录/发布测试 |
| WAL | SQLite 先记写入日志,再合并进主文件 | 运行中可能看到 .db-wal |
| DTO / VO | 描述接口输入输出的数据结构 | Go 的 NoteInput / Note |
| ORM | 把程序对象映射成数据库操作的库 | 当前使用 database/sql,不使用 ORM |
读不懂时,把“名词”换成本项目的一次实际动作。例如会话不是抽象概念:点击登录后多了一行 sessions,点击退出后那行被删除。你能用数据库状态解释一个词,就比只记住英文全称更接近掌握。