MySQL 給表新增欄位與註解語法

MySQL 使用 ALTER TABLE ... ADD 新增欄位，並支援 COMMENT 為欄位添加說明註解，便於資料字典維護與團隊協作。

基本語法

ALTER TABLE `tableName` 
ADD `newColumn` VARCHAR(8) COMMENT '新增欄位的業務含義說明';

關鍵點解析

完整範例

-- 在 user 表的 email 之後新增 phone 欄位，帶註解與非空預設值
ALTER TABLE `user` 
ADD `phone` VARCHAR(20) NOT NULL DEFAULT '' COMMENT '用戶手機號' 
AFTER `email`;

-- 一次新增多個欄位
ALTER TABLE `order` 
ADD `pay_time` DATETIME COMMENT '支付時間',
ADD `refund_status` TINYINT NOT NULL DEFAULT 0 COMMENT '退款狀態 0無 1申請中 2已退款',
ADD `remark` VARCHAR(500) COMMENT '備註';

查看欄位註解

-- 方法一：SHOW FULL COLUMNS
SHOW FULL COLUMNS FROM `user`;

-- 方法二：查詢 information_schema
SELECT COLUMN_NAME, COLUMN_COMMENT 
FROM INFORMATION_SCHEMA.COLUMNS 
WHERE TABLE_SCHEMA = 'your_db' AND TABLE_NAME = 'user';

修改現有欄位註解

-- 必須重新聲明完整欄位定義 (類型、屬性、註解)
ALTER TABLE `user` 
MODIFY `phone` VARCHAR(20) NOT NULL DEFAULT '' COMMENT '用戶手機號(已驗證)';

最佳實踐

1. 所有欄位強制加 COMMENT：納入資料庫設計規範，Code Review 檢查項目。
2. 註解內容標準化：格式如「業務含義(枚舉值說明/單位/來源)」，例如 '訂單狀態 0待付款 1已付款 2已發貨 3已完成 4已取消'。
3. 避免中文逗號、特殊符號：單引號內容建議純中英文數字標點，防止編碼/匯出問題。 4. 配合工具自動生成文檔：如 Squirrel SQL、DataGrip、自動化腳本讀取 INFORMATION_SCHEMA.COLUMNS 產出 Markdown/Excel 資料字典。

良好的欄位註解習慣，能大幅降低新人上手成本、減少溝通誤解、支援自動化文檔產出，是資料庫治理的基礎細節。