SQL Server 允許表名以數字開頭(如 1_TableName),但這是一個充滿陷阱的「合法但不推薦」特性。本文深度解析查詢報錯根因、方括號轉義機制、ORM/工具生成代碼的隱患,並給出企業級命名規範建議。
-- ❌ 錯誤:語法錯誤,數字被解析為數值字面量 SELECT * FROM 1_TableName; -- ✅ 正確:方括號轉義標識符 SELECT * FROM [1_TableName];
SQL Server 解析器將 1_TableName 視為數字 1 後跟非法字符,而非單一標識符。方括號 [] 是 T-SQL 標準的定界符,強制將內容視為對象名稱。
[2023_Sales][Order Details], [User-Name][Select], [Group], [Order]Visual Studio DataSet 設計器、Entity Framework、Dapper 等 ORM/工具在生成 SQL 時:
SELECT [Id] FROM [1_Table]SELECT Id FROM 1_Table → **運行時拋異常**| 規則 | 推薦 | 避免 | 理由 |
|---|---|---|---|
| 首字符 | 字母、下劃線 | 數字 | 避免轉義、提升可讀性、跨工具兼容 |
| 分隔符 | 下劃線 _ | 空格、連字符 -、點 . | 標準化、無需轉義 |
| 大小寫 | PascalCase 或 snake_case 統一 | 混用 | 團隊一致性、版本控制 diff 乾淨 |
| 前綴 | 業務域縮寫 ord_, usr_ | 系統前綴 tbl_, sp_ | 語義分組、避免系統對象衝突 |
| 長度 | ≤ 30 字符 | 過長 | 可讀性、部份工具截斷風險 |
ord_OrderHeader, usr_UserProfile, prd_ProductSkuorder_header, user_profile, product_sku (snake_case 派)1_Order, Order Details, Select, tblOrderEXEC sp_rename '1_TableName', 'Ord_TableName';更新所有依賴對象(視圖、SP、函數、觸發器、應用代碼)
CREATE VIEW v_TableName AS SELECT * FROM [1_TableName];新代碼查詢視圖,舊表逐步淘汰
CREATE SYNONYM Syn_TableName FOR [CurrentDB].[dbo].[1_TableName];
modelBuilder.Entity().ToTable("1_TableName") → EF Core 會自動加方括號,但建議 Fluent API 顯式映射[@TableName] 模式sp_rename 合規性檢查腳本1_Table」底線思維:數據庫對象命名不是個人喜好,而是系統穩定性、團隊協作效率、工具鏈兼容性的契約。多敲幾個字母
[]或換個前綴,換來的是無數個深夜不被喚醒的安穩。