您现在的位置：程式碼之家 >> 編程語言 > >> 更多程式語言 >> 程式設計疑難解答

雲筆記系統設計指南：數據庫表結構與存儲方案選型

編輯：程式設計疑難解答

系統定位

畢業設計級雲筆記，Web 端，核心功能：用戶管理、筆記增刪改查、分類標籤、圖片附件、多端同步。

核心數據庫表設計

1. 用戶表


CREATE TABLE `user` (
  `id` BIGINT PRIMARY KEY AUTO_INCREMENT,
  `username` VARCHAR(50) NOT NULL UNIQUE,
  `password_hash` VARCHAR(100) NOT NULL,
  `email` VARCHAR(100) UNIQUE,
  `avatar_url` VARCHAR(255),
  `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
  `updated_at` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

2. 筆記本/分類表


CREATE TABLE `notebook` (
  `id` BIGINT PRIMARY KEY AUTO_INCREMENT,
  `user_id` BIGINT NOT NULL,
  `name` VARCHAR(100) NOT NULL,
  `icon` VARCHAR(50),
  `sort_order` INT DEFAULT 0,
  `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
  FOREIGN KEY (`user_id`) REFERENCES `user`(`id`)
);

3. 筆記主表


CREATE TABLE `note` (
  `id` BIGINT PRIMARY KEY AUTO_INCREMENT,
  `user_id` BIGINT NOT NULL,
  `notebook_id` BIGINT,
  `title` VARCHAR(200) NOT NULL,
  `content` LONGTEXT, -- 純文本/Markdown/HTML
  `content_type` ENUM('markdown','html','text') DEFAULT 'markdown',
  `is_deleted` TINYINT DEFAULT 0,
  `is_favorite` TINYINT DEFAULT 0,
  `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
  `updated_at` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  FOREIGN KEY (`user_id`) REFERENCES `user`(`id`),
  FOREIGN KEY (`notebook_id`) REFERENCES `notebook`(`id`),
  INDEX `idx_user_updated` (`user_id`, `updated_at`)
);

4. 標籤表（多對多）


CREATE TABLE `tag` (
  `id` BIGINT PRIMARY KEY AUTO_INCREMENT,
  `user_id` BIGINT NOT NULL,
  `name` VARCHAR(50) NOT NULL,
  UNIQUE KEY `uk_user_name` (`user_id`, `name`)
);

CREATE TABLE `note_tag` (
  `note_id` BIGINT NOT NULL,
  `tag_id` BIGINT NOT NULL,
  PRIMARY KEY (`note_id`, `tag_id`),
  FOREIGN KEY (`note_id`) REFERENCES `note`(`id`) ON DELETE CASCADE,
  FOREIGN KEY (`tag_id`) REFERENCES `tag`(`id`) ON DELETE CASCADE
);

5. 圖片/附件表


CREATE TABLE `attachment` (
  `id` BIGINT PRIMARY KEY AUTO_INCREMENT,
  `note_id` BIGINT NOT NULL,
  `file_name` VARCHAR(255),
  `file_path` VARCHAR(500), -- OSS 路徑或相對路徑
  `file_size` BIGINT,
  `mime_type` VARCHAR(100),
  `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
  FOREIGN KEY (`note_id`) REFERENCES `note`(`id`) ON DELETE CASCADE
);

存儲方案選型：數據庫 vs 文件系統 vs 對象存儲

方案	優點	缺點	適用場景
數據庫 BLOB/TEXT	事務一致性、備份簡單、無需額外組件	大對象膨脹備份/恢復慢、連接池壓力大、不利於 CDN 分發	小型項目、文本為主、附件極少
服務器本地文件系統	讀寫性能高、無網絡開銷	單點故障、擴展困難、多機部署需共享存儲 (NFS/GlusterFS)	單機部署、附件較大
對象存儲 (OSS/S3/MinIO)	無限擴展、高可用、CDN 加速、簽名直傳減輕服務器	引入外部依賴、最終一致性、成本隨量增長	生產環境、多端同步、圖片/文件較多