C# 實作單據編號自動遞增演算法：支援任意前綴與位數

需求分析

企業系統常需產生流水號：INV-20240001、PO-000123、CR20240615001。核心邏輯為「取得最後一筆編號 → 解析數字部分 → +1 → 重組」。本文提供通用演算法支援：

• 純數字遞增
• 固定前綴 + 數字
• 含日期/年月 + 數字
• 自動補零維持固定寬度

核心演算法：字串尾數遞增

/// 

/// 將字串尾部的數字部分 +1，保持前綴與位數不變。
/// 範例: "DJ000002" → "DJ000003", "999" → "1000", "A9Z" → "A10Z" (僅尾部連續數字)
/// 
public static string IncrementTailNumber(string input)
{
    if (string.IsNullOrEmpty(input)) return "1";

    char[] chars = input.ToCharArray();
    int i = chars.Length - 1;

    // 1. 找到尾部連續數字區段起始索引
    while (i >= 0 && char.IsDigit(chars[i])) i--;
    int numStart = i + 1;

    // 2. 無數字尾碼 → 直接加 "1"
    if (numStart == chars.Length)
        return input + "1";

    // 3. 解析數字、遞增、格式化回原寬度 (或自動展寬)
    string numStr = new string(chars, numStart, chars.Length - numStart);
    if (long.TryParse(numStr, out long num))
    {
        num++;
        string newNumStr = num.ToString().PadLeft(numStr.Length, '0'); // 補零
        // 組合前綴 + 新數字
        return new string(chars, 0, numStart) + newNumStr;
    }

    // 解析失敗 (極長數字超過 long) → 退回字串加法
    return input + "1"; // 簡化處理，實務可用 BigInteger
}

進階版：支援分隔符與日期重置

public class DocumentNumberGenerator
{
    private readonly string _prefix;       // 固定前綴，如 "INV-"
    private readonly int _serialWidth;     // 序號固定寬度，如 6 → 000001
    private readonly string _dateFormat;   // 日期格式，如 "yyyyMMdd"，空字串表示不含日期
    private readonly char _separator;      // 日期與序號分隔符，如 '-'
    private long _lastSerial;              // 記憶體中快取 (需配合持久化)
    private DateTime _lastDate;

    public DocumentNumberGenerator(string prefix, int serialWidth, string dateFormat = "", char separator = '-')
    {
        _prefix = prefix ?? "";
        _serialWidth = Math.Max(1, serialWidth);
        _dateFormat = dateFormat ?? "";
        _separator = separator;
    }

    /// 

    /// 產生下一張單號 (執行緒安全)
    /// 
    public string NextNumber()
    {
        lock (this)
        {
            DateTime today = DateTime.Today;
            string datePart = _dateFormat.Length > 0 ? today.ToString(_dateFormat) : "";
            
            // 日期變更 → 重置序號
            if (today != _lastDate)
            {
                _lastDate = today;
                _lastSerial = 0;
            }

            _lastSerial++;
            string serialPart = _lastSerial.ToString().PadLeft(_serialWidth, '0');

            return _prefix + datePart + (_dateFormat.Length > 0 ? _separator.ToString() : "") + serialPart;
        }
    }

    /// 

    /// 從現有單號初始化狀態 (系統啟動時呼叫)
    /// 
    public void InitializeFrom(string lastNumber)
    {
        if (string.IsNullOrEmpty(lastNumber) || !lastNumber.StartsWith(_prefix)) return;

        string body = lastNumber[_prefix.Length..];
        if (_dateFormat.Length > 0)
        {
            int dateLen = _dateFormat.Length; // 簡化假設固定長度
            if (body.Length > dateLen && body[dateLen] == _separator)
            {
                string dateStr = body[..dateLen];
                if (DateTime.TryParseExact(dateStr, _dateFormat, null, DateTimeStyles.None, out var dt))
                {
                    _lastDate = dt;
                    string serialStr = body[(dateLen + 1)..];
                    if (long.TryParse(serialStr, out long serial))
                        _lastSerial = serial;
                }
            }
        }
        else
        {
            // 純前綴+序號
            if (long.TryParse(body, out long serial))
                _lastSerial = serial;
        }
    }
}

使用範例

// 1. 簡單尾數遞增
string next = IncrementTailNumber("DJ000002"); // "DJ000003"
next = IncrementTailNumber("PO-999");          // "PO-1000" (自動展寬)
next = IncrementTailNumber("ABC");             // "ABC1"

// 2. 進階產生器
var gen = new DocumentNumberGenerator("INV-", 6, "yyyyMMdd", '-');
gen.InitializeFrom("INV-20240615-000042"); // 從資料庫讀取最後一筆
Console.WriteLine(gen.NextNumber()); // "INV-20240615-000043"
Console.WriteLine(gen.NextNumber()); // "INV-20240615-000044"

// 跨日重置測試
// ... 系統日期變更為 2024/06/16 ...
Console.WriteLine(gen.NextNumber()); // "INV-20240616-000001"

// 3. 純序號 (無日期)
var simpleGen = new DocumentNumberGenerator("CR", 5);
simpleGen.InitializeFrom("CR00123");
Console.WriteLine(simpleGen.NextNumber()); // "CR00124"

持久化與高併發考量

資料庫序列最佳實務 (SQL Server / PostgreSQL)

-- SQL Server
CREATE SEQUENCE dbo.Seq_InvoiceNo AS BIGINT START WITH 1 INCREMENT BY 1;
-- 取號
SELECT NEXT VALUE FOR dbo.Seq_InvoiceNo; -- 回傳 1, 2, 3...

-- 組合單號 (應用層組裝)
-- "INV-" + FORMAT(GETDATE(), 'yyyyMMdd') + "-" + NEXT VALUE FOR Seq_InvoiceNo.ToString("D6")

效能基準測試

// 100 萬次遞增耗時 (Release, x64, i7-12700H)
IncrementTailNumber: ~45 ms
DocumentNumberGenerator.NextNumber (lock): ~120 ms
Interlocked.Increment + 字串格式化: ~30 ms (無鎖，但無日期重置邏輯)

高頻場景 (>10k/sec) 建議改用 Interlocked.Increment 維護長整數序號，格式化延遲至輸出時。

總結

• 簡單需求用 IncrementTailNumber 字串操作即可。
• 含日期重置、固定寬度、前綴需求用 DocumentNumberGenerator。
• 分散式環境務必使用資料庫序列或協調服務，勿靠應用層記憶體。
• 單號一旦產生不可重複，持久化機制需經嚴格測試 (斷電、異常中止、時鐘回撥)。