Python random.choice() 函數教學：從序列隨機選取元素

random.choice(seq) 從非空序列（列表、元組、字串、range 等）中等機率隨機回傳一個元素。本文說明語法、參數、回傳值、常見用法、錯誤處理與進階變體。

函數簽名

import random
random.choice(seq)  # seq: 非空序列

基本範例

import random

print(random.choice([1, 2, 3, 5, 9]))      # 如 2
print(random.choice('A String'))           # 如 'n'
print(random.choice(('red', 'green', 'blue')))  # 如 'green'
print(random.choice(range(10)))            # 0-9 隨機整數

常見用法

1. 隨機挑選列表項目：抽獎、A/B 測試分桶、隨機測試資料。
2. 字串隨機字元：產生驗證碼、臨時密碼片段。
3. 加權隨機（需自行實作）：choice 僅等機率，加權請用 random.choices(population, weights, k=1)[0] (Python 3.6+)。

錯誤處理

try:
    random.choice([])
except IndexError as e:
    print(e)  # Cannot choose from an empty sequence

生產碼建議先檢查 if seq: 或捕獲 IndexError。

進階變體

效能提示

• choice 內部呼叫 randrange(len(seq)) 後索引，O(1)。
• 若序列極大且頻繁呼叫，考慮預先轉為 list 或使用 random.randrange 直接算索引。
• 密集迴圈中可區域綁定：_choice = random.choice 避免屬性查找開銷。

常見誤區

• 以為 choice 會修改原序列 → 不會，唯讀操作。
• 傳入集合 set 或字典 dict → TypeError（無序、不支援索引），需先 list(s)。
• 字串被視為字元序列，choice('abc') 回傳單一字元而非子字串。

random.choice 是最直覺的隨機選取工具，搭配 choices、sample、secrets.choice 可覆蓋從簡單抽獎到密碼學安全的各種隨機需求。