Python 函數(shù) return 多個數(shù)據(jù)：用法、實(shí)例與實(shí)戰(zhàn)技巧

在 Python 編程中，函數(shù)是代碼復(fù)用與邏輯封裝的核心載體。多數(shù)場景下，我們需要函數(shù)返回單一結(jié)果（如計(jì)算兩數(shù)之和返回一個數(shù)值），但實(shí)際開發(fā)中，常遇到 “一次調(diào)用需獲取多個關(guān)聯(lián)結(jié)果” 的需求 —— 例如計(jì)算矩形的 “面積與周長”、分析數(shù)據(jù)集的 “總和與均值”、查詢用戶信息時(shí)返回 “姓名、年齡與訂單數(shù)量”。此時(shí)，Python 支持的 “函數(shù) return 多個數(shù)據(jù)” 功能便成為高效解決方案。本文將從基礎(chǔ)原理出發(fā)，通過豐富實(shí)例講解其用法，結(jié)合實(shí)戰(zhàn)場景說明應(yīng)用技巧，幫助開發(fā)者靈活應(yīng)對多結(jié)果返回需求。

一、為什么需要函數(shù)返回多個數(shù)據(jù)？—— 場景與價(jià)值

在未掌握多數(shù)據(jù)返回前，若需函數(shù)輸出多個結(jié)果，往往需借助 “全局變量”“列表臨時(shí)存儲” 或 “多次函數(shù)調(diào)用”，這些方式存在明顯缺陷：

• 全局變量：易造成變量污染，破壞函數(shù)封裝性；

• 列表臨時(shí)存儲：需手動解析列表元素含義，可讀性差；

• 多次調(diào)用：重復(fù)執(zhí)行函數(shù)邏輯（如重復(fù)遍歷數(shù)據(jù)集計(jì)算總和與均值），降低效率。

而 Python 的多數(shù)據(jù)返回功能，可直接通過一個函數(shù)調(diào)用獲取多個關(guān)聯(lián)結(jié)果，兼具 “效率、可讀性、封裝性” 三大優(yōu)勢，適用于以下核心場景：

1. 數(shù)據(jù)統(tǒng)計(jì)分析：一次返回?cái)?shù)據(jù)集的 “總和、均值、中位數(shù)、標(biāo)準(zhǔn)差”；

2. 多結(jié)果計(jì)算：如幾何圖形的 “面積與周長”、兩數(shù)的 “和、差、積、商”；

3. 業(yè)務(wù)信息查詢：返回用戶的 “基礎(chǔ)信息（姓名 / 年齡）+ 業(yè)務(wù)數(shù)據(jù)（訂單數(shù) / 消費(fèi)額）”；

4. 狀態(tài)與結(jié)果同步：返回 “操作是否成功（布爾值）+ 結(jié)果數(shù)據(jù) / 錯誤信息”。

二、Python 函數(shù)返回多個數(shù)據(jù)的本質(zhì)：不是 “多值返回”，而是 “容器封裝”

Python 并不支持真正意義上的 “多值返回”，其底層邏輯是：將多個數(shù)據(jù)封裝成一個 “容器對象”（如元組、列表、字典），函數(shù)實(shí)際返回的是這個容器，再通過 “解包” 操作提取其中的多個數(shù)據(jù)。

其中，元組（tuple）是默認(rèn)的封裝類型—— 當(dāng)函數(shù) return 后緊跟多個數(shù)據(jù)時(shí)，Python 會自動將其打包為元組；若需明確指定容器類型，也可手動封裝為列表、字典或自定義對象。

理解這一本質(zhì)，能幫助我們避免 “多值返回” 的認(rèn)知誤區(qū)，更靈活地選擇封裝方式。

三、不同類型的多數(shù)據(jù)返回實(shí)例：從基礎(chǔ)到進(jìn)階

根據(jù)返回容器的不同，Python 函數(shù)多數(shù)據(jù)返回可分為 “元組返回（默認(rèn)）”“列表返回”“字典返回”“對象返回” 四類，各自適用于不同場景，以下結(jié)合實(shí)例詳細(xì)說明。

（一）默認(rèn)方式：返回元組（最常用，簡潔高效）

當(dāng)函數(shù) return 多個數(shù)據(jù)且未指定容器時(shí)，Python 會自動將其打包為元組。調(diào)用函數(shù)時(shí)，可通過 “變量解包” 直接獲取單個數(shù)據(jù)，無需手動解析元組。

實(shí)例 1：計(jì)算矩形的面積與周長

def calculate_rectangle(length, width):

   """計(jì)算矩形的面積與周長，返回兩個結(jié)果"""

   area = length * width  # 面積 = 長 × 寬

   perimeter = 2 * (length + width)  # 周長 = 2×(長+寬)

   return area, perimeter  # 自動打包為元組 (area, perimeter)

# 調(diào)用函數(shù)：解包元組，將兩個結(jié)果分別賦值給變量

rect_area, rect_perimeter = calculate_rectangle(5, 3)

# 輸出結(jié)果

print(f"矩形面積：{rect_area}")  # 輸出：矩形面積：15

print(f"矩形周長：{rect_perimeter}")  # 輸出：矩形周長：16

關(guān)鍵說明：

• 函數(shù)返回時(shí)無需寫括號（return (area, perimeter) 與 return area, perimeter 效果一致），Python 默認(rèn)打包為元組；

• 解包時(shí)，變量數(shù)量需與返回?cái)?shù)據(jù)數(shù)量一致（若多寫變量會報(bào)錯，少寫則獲取部分?jǐn)?shù)據(jù)，需用 _ 忽略無關(guān)值，如 rect_area, _ = calculate_rectangle(5, 3) 僅獲取面積）；

• 適用場景：返回數(shù)據(jù)關(guān)聯(lián)緊密、數(shù)量固定且無需明確標(biāo)識（如 “面積與周長”“和與差”）。

（二）靈活選擇：返回列表（支持動態(tài)修改結(jié)果）

若返回的多個數(shù)據(jù)需要后續(xù)修改（如添加、刪除元素），可手動將數(shù)據(jù)封裝為列表返回。列表與元組的核心區(qū)別是 “可變性”，因此列表更適合 “需二次處理結(jié)果” 的場景。

實(shí)例 2：分析列表的 “極值與元素個數(shù)”

def analyze_list(num_list):

   """分析數(shù)字列表，返回最大值、最小值、元素個數(shù)（列表形式）"""

   if not num_list:  # 處理空列表場景

       return [None, None, 0]

   max_val = max(num_list)

   min_val = min(num_list)

   count = len(num_list)

   return [max_val, min_val, count]  # 手動封裝為列表

# 調(diào)用函數(shù)并獲取結(jié)果

result = analyze_list([12, 5, 23, 8, 3])

print("原始結(jié)果：", result)  # 輸出：原始結(jié)果：[23, 5, 5]

# 對返回的列表進(jìn)行二次修改（如添加平均值）

avg_val = sum(result[:2]) / 2  # 計(jì)算最大最小值的平均值

result.append(avg_val)

print("添加平均值后的結(jié)果：", result)  # 輸出：添加平均值后的結(jié)果：[23, 5, 5, 14.0]

關(guān)鍵說明：

• 列表返回需手動用 [] 封裝數(shù)據(jù)，后續(xù)可通過列表方法（append/insert/pop）修改結(jié)果；

• 適用場景：返回?cái)?shù)據(jù)需二次加工（如添加額外計(jì)算結(jié)果）、數(shù)據(jù)數(shù)量可能動態(tài)變化。

（三）清晰標(biāo)識：返回字典（明確數(shù)據(jù)含義，可讀性優(yōu)先）

當(dāng)返回?cái)?shù)據(jù)較多或需要明確區(qū)分每個結(jié)果的含義時(shí)，使用字典返回是最佳選擇 —— 字典的 “鍵（key）” 可直接標(biāo)識數(shù)據(jù)語義，避免 “通過索引猜含義” 的問題，尤其適合團(tuán)隊(duì)協(xié)作場景。

實(shí)例 3：獲取學(xué)生的 “成績詳情”

def get_student_grade(student_id):

   """根據(jù)學(xué)生ID，返回成績詳情（字典形式，含科目分?jǐn)?shù)、總分、等級）"""

   # 模擬從數(shù)據(jù)庫獲取數(shù)據(jù)（實(shí)際開發(fā)中替換為真實(shí)查詢邏輯）

   grades = {

       "math": 92,

       "english": 88,

       "python": 95

   }

   total = sum(grades.values())  # 計(jì)算總分

   avg = total / len(grades)     # 計(jì)算平均分

  

   # 判定等級

   if avg >= 90:

       level = "A"

   elif avg >= 80:

       level = "B"

   else:

       level = "C"

  

   # 返回字典：鍵明確標(biāo)識數(shù)據(jù)含義

   return {

       "student_id": student_id,

       "subject_grades": grades,

       "total_score": total,

       "average_score": round(avg, 1),  # 保留1位小數(shù)

       "grade_level": level

   }

# 調(diào)用函數(shù)，通過字典鍵獲取指定結(jié)果

student_result = get_student_grade("2025001")

print(f"學(xué)生{student_result['student_id']}總分：{student_result['total_score']}")

print(f"平均分：{student_result['average_score']}，等級：{student_result['grade_level']}")

print(f"Python成績：{student_result['subject_grades']['python']}")

# 輸出結(jié)果：

# 學(xué)生2025001總分：275

# 平均分：91.7，等級：A

# Python成績：95

關(guān)鍵說明：

• 字典的鍵需具備語義化（如 total_score“grade_level”），避免使用無意義的鍵（如 key1“key2”）；

• 調(diào)用時(shí)通過 字典名['鍵名'] 提取數(shù)據(jù)，無需記憶索引位置，可讀性極強(qiáng)；

• 適用場景：返回?cái)?shù)據(jù)較多（3 個以上）、需明確區(qū)分?jǐn)?shù)據(jù)含義、團(tuán)隊(duì)協(xié)作或接口開發(fā)（需給調(diào)用方清晰的數(shù)據(jù)說明）。

（四）復(fù)雜場景：返回自定義對象（結(jié)構(gòu)化數(shù)據(jù)的終極方案）

當(dāng)返回?cái)?shù)據(jù)包含 “屬性” 與 “方法”（如用戶信息不僅有基本字段，還需驗(yàn)證手機(jī)號格式）時(shí)，可定義一個類，讓函數(shù)返回該類的對象 —— 這是面向?qū)ο缶幊讨刑幚韽?fù)雜結(jié)構(gòu)化數(shù)據(jù)的標(biāo)準(zhǔn)方式。

實(shí)例 4：返回 “用戶信息對象” 并調(diào)用對象方法

class User:

   """用戶類：封裝用戶屬性與方法"""

   def __init__(self, name, age, phone, order_count):

       self.name = name          # 姓名

       self.age = age            # 年齡

       self.phone = phone        # 手機(jī)號

       self.order_count = order_count  # 訂單數(shù)量


   def is_adult(self):

       """判斷是否為成年人"""

       return self.age >= 18



   def format_phone(self):

       """格式化手機(jī)號（如138****1234）"""

       if len(self.phone) == 11:

           return f"{self.phone[:3]}****{self.phone[7:]}"

       return "手機(jī)號格式錯誤"

def get_user_info(user_id):

   """根據(jù)用戶ID，返回User對象（含屬性與方法）"""

   # 模擬數(shù)據(jù)庫查詢結(jié)果

   user_data = {

       "name": "張三",

       "age": 25,

       "phone": "13812345678",

       "order_count": 12

   }

   # 返回User對象，封裝所有屬性與方法

   return User(

       name=user_data["name"],

       age=user_data["age"],

       phone=user_data["phone"],

       order_count=user_data["order_count"]

   )

# 調(diào)用函數(shù)獲取User對象，訪問屬性與調(diào)用方法

user = get_user_info("U20250815")

print(f"用戶名：{user.name}，訂單數(shù)：{user.order_count}")

print(f"是否成年：{user.is_adult()}")

print(f"格式化手機(jī)號：{user.format_phone()}")

# 輸出結(jié)果：

# 用戶名：張三，訂單數(shù)：12

# 是否成年：True

# 格式化手機(jī)號：138****5678

關(guān)鍵說明：

• 自定義對象將 “數(shù)據(jù)（屬性）” 與 “邏輯（方法）” 封裝在一起，適合處理復(fù)雜業(yè)務(wù)（如用戶信息驗(yàn)證、訂單數(shù)據(jù)計(jì)算）；

• 適用場景：返回?cái)?shù)據(jù)需關(guān)聯(lián)業(yè)務(wù)邏輯（如驗(yàn)證、格式化、計(jì)算）、數(shù)據(jù)結(jié)構(gòu)復(fù)雜且需復(fù)用（如在多個函數(shù)中傳遞同一類數(shù)據(jù)）。

四、實(shí)戰(zhàn)場景：多數(shù)據(jù)返回函數(shù)的典型應(yīng)用

場景 1：數(shù)據(jù)處理 —— 計(jì)算數(shù)據(jù)集的核心統(tǒng)計(jì)指標(biāo)

import statistics

def get_data_stats(data):

   """計(jì)算數(shù)據(jù)集的核心統(tǒng)計(jì)指標(biāo)：總和、均值、中位數(shù)、標(biāo)準(zhǔn)差"""

   if not data:

       return None, None, None, None  # 空數(shù)據(jù)返回None

   total = sum(data)

   mean = statistics.mean(data)

   median = statistics.median(data)

   std_dev = statistics.stdev(data) if len(data) > 1 else 0  # 標(biāo)準(zhǔn)差需至少2個數(shù)據(jù)

   return total, mean, median, std_dev

# 測試：分析月度銷售額數(shù)據(jù)

sales_data = [52000, 68000, 75000, 63000, 81000]

total_sales, avg_sales, median_sales, std_sales = get_data_stats(sales_data)

print(f"月度總銷售額：{total_sales:,}元")

print(f"月均銷售額：{avg_sales:,.1f}元")

print(f"銷售額中位數(shù)：{median_sales:,}元")

print(f"銷售額標(biāo)準(zhǔn)差：{std_sales:,.1f}元")  # 反映數(shù)據(jù)波動程度

場景 2：業(yè)務(wù)邏輯 —— 用戶登錄驗(yàn)證與信息返回

def user_login(username, password):

   """用戶登錄驗(yàn)證：返回（登錄狀態(tài)，提示信息，用戶數(shù)據(jù)）"""

   # 模擬用戶數(shù)據(jù)庫（實(shí)際為數(shù)據(jù)庫查詢）

   valid_users = {

       "admin": {"password": "123456", "role": "管理員", "login_count": 156},

       "user123": {"password": "abc789", "role": "普通用戶", "login_count": 23}

   }


   # 驗(yàn)證邏輯

   if username not in valid_users:

       return False, "用戶名不存在", None

   if valid_users[username]["password"] != password:

       return False, "密碼錯誤", None



   # 登錄成功：更新登錄次數(shù)（模擬數(shù)據(jù)庫更新）

   valid_users[username]["login_count"] += 1

   user_data = valid_users[username]

   return True, "登錄成功", user_data

# 調(diào)用函數(shù)并處理結(jié)果

login_status, msg, user = user_login("admin", "123456")

if login_status:

   print(f"{msg}！用戶角色：{user['role']}，累計(jì)登錄次數(shù)：{user['login_count']}")

else:

   print(f"登錄失?。簕msg}")

五、使用注意事項(xiàng)與最佳實(shí)踐

1. 解包時(shí)注意 “變量數(shù)量匹配”

函數(shù)返回的多數(shù)據(jù)需通過 “解包” 獲取，若變量數(shù)量與返回?cái)?shù)據(jù)數(shù)量不匹配，會觸發(fā) ValueError：

# 錯誤示例：返回2個數(shù)據(jù)，卻用3個變量接收

area, perimeter, extra = calculate_rectangle(5, 3)  # 報(bào)錯：too many values to unpack (expected 3)

# 正確處理：用`_`忽略無關(guān)數(shù)據(jù)（僅獲取面積）

area, _ = calculate_rectangle(5, 3)

2. 優(yōu)先選擇 “語義化返回方式”

• 數(shù)據(jù)量≤2 個且關(guān)聯(lián)緊密：用元組（簡潔高效）；

• 數(shù)據(jù)量≥3 個或需明確含義：用字典（可讀性優(yōu)先）；

• 數(shù)據(jù)需關(guān)聯(lián)業(yè)務(wù)邏輯：用自定義對象（結(jié)構(gòu)化封裝）；

• 避免用列表返回 “固定含義數(shù)據(jù)”（列表無語義標(biāo)識，易混淆）。

3. 處理 “空數(shù)據(jù)” 或 “異常場景”

函數(shù)返回多數(shù)據(jù)時(shí)，需提前考慮異常情況（如空輸入、計(jì)算錯誤），避免返回 “不完整數(shù)據(jù)”：

def divide_and_remainder(a, b):

   """計(jì)算兩數(shù)的商與余數(shù)，處理除數(shù)為0的異常"""

   if b == 0:

       return None, None, "除數(shù)不能為0"  # 返回None+錯誤信息

   quotient = a // b

   remainder = a % b

   return quotient, remainder, "計(jì)算成功"

# 調(diào)用時(shí)判斷異常

q, r, msg = divide_and_remainder(10, 0)

if q is None:

   print(f"錯誤：{msg}")

else:

   print(f"商：{q}，余數(shù)：{r}")

六、結(jié)語

Python 函數(shù) return 多個數(shù)據(jù)，本質(zhì)是 “容器封裝 + 解包” 的語法糖，卻極大提升了代碼效率與可讀性。從簡單的元組返回，到復(fù)雜的對象返回，不同方式適用于不同場景 —— 核心原則是 “兼顧效率與可讀性，貼合業(yè)務(wù)需求”。

在實(shí)際開發(fā)中，靈活運(yùn)用多數(shù)據(jù)返回函數(shù)，可避免冗余代碼（如多次函數(shù)調(diào)用）、減少變量污染（如替代全局變量），讓代碼更簡潔、邏輯更清晰。無論是數(shù)據(jù)處理、業(yè)務(wù)邏輯，還是接口開發(fā)，多數(shù)據(jù)返回都是 Python 開發(fā)者必備的核心技巧之一。掌握其用法與最佳實(shí)踐，能顯著提升編程效率，應(yīng)對更復(fù)雜的開發(fā)場景。

學(xué)習(xí)入口：https://edu.cda.cn/goods/show/3814?targetId=6587&preview=0

推薦學(xué)習(xí)書籍 《CDA一級教材》適合CDA一級考生備考，也適合業(yè)務(wù)及數(shù)據(jù)分析崗位的從業(yè)者提升自我。完整電子版已上線CDA網(wǎng)校，累計(jì)已有10萬+在讀~ !

免費(fèi)加入閱讀：https://edu.cda.cn/goods/show/3151?targetId=5147&preview=0