# 词汇表：第一次见到时这样理解

| 术语 | 通俗解释 | 本项目例子 |
| --- | --- | --- |
| 项目根目录 | 放着整套工程入口的文件夹 | `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，点击退出后那行被删除。你能用数据库状态解释一个词，就比只记住英文全称更接近掌握。
