Python基础指南之元组的打包与解包操作详解

# 打包（Packing）：将多个值组合成一个元组
t = 1, 2, 3  # 打包为一个元组
print(t)  # (1, 2, 3)
print(type(t))  # <class 'tuple'>

# 解包（Unpacking）：将元组（或其他可迭代对象）拆开，赋给多个变量
a, b, c = t  # 解包
print(a, b, c)  # 1 2 3

# 打包和解包往往是一对操作
# 函数返回多个值 = 打包
# 接收多个返回值 = 解包
def min_max(lst):
    return min(lst), max(lst)  # 打包返回元组

lowest, highest = min_max([5, 2, 8, 1, 9])  # 解包接收
print(lowest, highest)  # 1 9

# 解包语法：变量数量必须和可迭代对象的元素数量匹配
data = (1, 2, 3)

# 标准解包——变量数匹配元素数
a, b, c = data
print(a, b, c)  # 1 2 3

# 变量太少 → 报错
# a, b = data  # ValueError: too many values to unpack (expected 2)

# 变量太多 → 报错
# a, b, c, d = data  # ValueError: not enough values to unpack (expected 4, got 3)

# 解包不限于元组——任何可迭代对象都可以
a, b, c = [1, 2, 3]        # 列表
a, b, c = 'abc'            # 字符串
a, b, c = range(3)         # range
a, b, c = {'x': 1, 'y': 2, 'z': 3}  # 字典（解包键）
a, b, c = {1, 2, 3}        # 集合（无序！）

# 两个变量的经典用法
# 交换变量值（Python的招牌操作）
a, b = 10, 20
a, b = b, a
print(a, b)  # 20 10

# 内部实际发生了什么：
# 1. 右边 b, a 被求值为元组 (20, 10)
# 2. 左边 a, b 将元组解包，分别赋值

# 遍历中的解包
pairs = [(1, 'a'), (2, 'b'), (3, 'c')]
for number, letter in pairs:
    print(f'{number} → {letter}')

# enumerate中的解包
fruits = ['苹果', '香蕉', '橘子']
for i, fruit in enumerate(fruits, 1):
    print(f'{i}. {fruit}')

# zip中的解包
names = ['小明', '小红', '小刚']
scores = [85, 92, 78]
for name, score in zip(names, scores):
    print(f'{name}: {score}分')

# 用 * 收集剩余元素
# 这是Python 3中引入的"扩展可迭代解包"（Extended Iterable Unpacking）

# 取第一个和最后一个，中间的全部收集
first, *middle, last = [1, 2, 3, 4, 5]
print(first)   # 1
print(middle)  # [2, 3, 4]（中间的全部！总是列表）
print(last)    # 5

# 取前两个，剩余的全部收集
first, second, *rest = range(10)
print(first, second)  # 0 1
print(rest)           # [2, 3, 4, 5, 6, 7, 8, 9]

# 取后两个，前面的全部收集
*head, second_last, last = range(10)
print(head)        # [0, 1, 2, 3, 4, 5, 6, 7]
print(second_last, last)  # 8 9

# 只有一个带星号的变量
# 可以放在开头、中间或结尾，但只能有一个
a, *b = [1, 2, 3]
print(a, b)  # 1 [2, 3]

*a, b = [1, 2, 3]
print(a, b)  # [1, 2] 3

# 不能有两个带星号的变量
# *a, *b = [1, 2, 3]  # SyntaxError

# *变量收集的总是列表（即使只有一个元素或没有元素）
single, *rest = [42]
print(rest)  # []（空列表）

*all_items, = [1, 2, 3]
print(all_items)  # [1, 2, 3]

# 场景一：分割路径
path = '/home/user/documents/report.pdf'
*dirs, filename = path.rsplit('/', 1)
print(f'目录: {dirs[0]}')   # /home/user/documents
print(f'文件名: {filename}')  # report.pdf

# 场景二：处理命令行参数
import sys
# python script.py input.txt --verbose --output result.txt
# command, *args = sys.argv

# 模拟
command, *args = 'script.py input.txt --verbose --output result.txt'.split()
print(f'命令: {command}')  # script.py
print(f'参数: {args}')     # ['input.txt', '--verbose', '--output', 'result.txt']

# 场景三：忽略特定元素
# 用 _ 作为占位符表示"我不关心这个值"
name, _, city = ('小明', 25, '北京')
print(f'{name}来自{city}')  # 小明来自北京

# 用 *_ 忽略多个不需要的元素
first, *_, last = range(100)
print(first, last)  # 0 99

# 场景四：分割列表
data = [3, 1, 4, 1, 5, 9, 2, 6]
pivot = data[0]
smaller = [x for x in data if x < pivot]
larger = [x for x in data if x >= pivot]
# 简化为（用解包）
partitioned = [x for x in data if x < pivot] + [pivot] + [x for x in data[1:] if x >= pivot]

# 解包可以嵌套使用
# 处理嵌套结构的元组

# 嵌套元组的解包
data = ('小明', (85, 92, 78))
name, (math, english, chinese) = data
print(f'{name}: 数学{math}, 英语{english}, 语文{chinese}')

# 多层嵌套
complex_data = ('项目A', [('小明', 85), ('小红', 92)])
project_name, [(name1, score1), (name2, score2)] = complex_data
print(f'{project_name}: {name1}={score1}, {name2}={score2}')

# 实际场景：解析JSON式的嵌套数据
response = ('success', (200, {'user': '小明', 'role': 'admin'}))
status, (code, data) = response
print(f'状态: {status}, 代码: [code], 用户: {data["user"]}')

# 配合*的嵌套解包
nested = (1, (2, 3, 4), 5)
a, (*b,), c = nested
print(a, b, c)  # 1 [2, 3, 4] 5

# 如果内部元组长度不固定
records = [
    (1, '小明', (85, 90)),
    (2, '小红', (92, 88, 95)),  # 多了一门课
]
for idx, name, scores in records:
    print(f'{idx}. {name}: {scores}（{len(scores)}门课，平均{sum(scores)/len(scores):.1f}）')

# zip + 解包 — Python中最优雅的并行遍历方式
names = ['小明', '小红', '小刚']
ages = [25, 23, 26]
cities = ['北京', '上海', '广州']

for name, age, city in zip(names, ages, cities):
    print(f'{name}, {age}岁, {city}')

# zip的逆操作——解包zip结果
pairs = list(zip(names, ages))
print(pairs)  # [('小明', 25), ('小红', 23), ('小刚', 26)]

# 用zip(*...)解包——转置
unzipped_names, unzipped_ages = zip(*pairs)
print(unzipped_names)  # ('小明', '小红', '小刚')
print(unzipped_ages)   # (25, 23, 26)

# 这是一种非常实用的技巧
# 例如：行列转置
table = [
    (1, 2, 3),
    (4, 5, 6),
    (7, 8, 9),
]
rows = list(zip(*table))
print(rows)  # [(1, 4, 7), (2, 5, 8), (3, 6, 9)]

# *args：将多个位置参数打包为元组
def log(*messages):
    """接受任意数量的消息"""
    for i, msg in enumerate(messages, 1):
        print(f'[{i}] {msg}')

log('启动服务', '连接数据库', '加载缓存', '开始监听')
# [1] 启动服务
# [2] 连接数据库
# [3] 加载缓存
# [4] 开始监听


# * 解包：将可迭代对象解包为位置参数
def configure(host, port, debug=False):
    print(f'配置: host={host}, port={port}, debug={debug}')

settings = ('localhost', 8080)
configure(*settings)  # 配置: host=localhost, port=8080, debug=False

settings_with_debug = ('prod.server.com', 443, True)
configure(*settings_with_debug)  # 配置: host=prod.server.com, port=443, debug=True


# ** 关键字参数打包与解包
def create_user(**kwargs):
    """接受任意的关键字参数"""
    defaults = {'role': 'user', 'active': True}
    defaults.update(kwargs)
    return defaults

user = create_user(name='小明', age=25, role='admin')
print(user)  # {'role': 'admin', 'active': True, 'name': '小明', 'age': 25}

# ** 解包字典为关键字参数
config = {'host': 'localhost', 'port': 5432, 'debug': True}
configure(**config)  # 配置: host=localhost, port=5432, debug=True

# 用 * 解包合并多个列表
list1 = [1, 2, 3]
list2 = [4, 5, 6]
list3 = [7, 8, 9]

combined = [*list1, *list2, *list3]
print(combined)  # [1, 2, 3, 4, 5, 6, 7, 8, 9]

# 在中间插入元素
full_list = [*list1, 100, 200, *list2]
print(full_list)  # [1, 2, 3, 100, 200, 4, 5, 6]

# 合并字典（Python 3.5+）
dict1 = {'a': 1, 'b': 2}
dict2 = {'c': 3, 'd': 4}
merged = {**dict1, **dict2}
print(merged)  # {'a': 1, 'b': 2, 'c': 3, 'd': 4}

# 合并时后面的覆盖前面的
defaults = {'host': 'localhost', 'port': 8080, 'debug': False}
overrides = {'port': 9090, 'debug': True}
final = {**defaults, **overrides}
print(final)  # {'host': 'localhost', 'port': 9090, 'debug': True}

# 合并集合同样可以用*
set1 = {1, 2, 3}
set2 = {3, 4, 5}
merged_set = {*set1, *set2}
print(merged_set)  # {1, 2, 3, 4, 5}

# 用解包实现快速排序
def quicksort(lst):
    if len(lst) <= 1:
        return lst
    pivot, *rest = lst  # 解包：第一个元素为基准，其余为rest
    smaller = [x for x in rest if x <= pivot]
    larger = [x for x in rest if x > pivot]
    return quicksort(smaller) + [pivot] + quicksort(larger)

nums = [3, 6, 1, 8, 4, 9, 2, 5, 7]
print(quicksort(nums))  # [1, 2, 3, 4, 5, 6, 7, 8, 9]

# 解析配置文件
def parse_config_line(line):
    """解析配置行：key = value"""
    key, value = line.split('=', 1)
    return key.strip(), value.strip()

config_text = '''
host = localhost
port = 8080
debug = true
'''

config = dict(parse_config_line(line)
              for line in config_text.strip().split('\n')
              if line.strip())

print(config)  # {'host': 'localhost', 'port': '8080', 'debug': 'true'}


# 解析CSV数据
csv_lines = [
    '姓名,年龄,城市,职业',
    '小明,25,北京,工程师',
    '小红,23,上海,设计师',
    '小刚,26,广州,分析师',
]

headers, *rows = csv_lines
print(f'表头: {headers}')

users = []
for row in rows:
    name, age, city, job = row.split(',')
    users.append({
        'name': name,
        'age': int(age),
        'city': city,
        'job': job,
    })

for user in users:
    print(f'{user["name"]}（{user["age"]}岁）, {user["city"]}, {user["job"]}')

# 用切片和解包结合，让代码更可读
record = '2025-06-15 14:30:25|ERROR|数据库连接超时|server01'

# 传统方式
parts = record.split('|')
timestamp = parts[0]
level = parts[1]
message = parts[2]
server = parts[3]

# 用解包——一行搞定
timestamp, level, message, server = record.split('|')
print(f'[{timestamp}] {level}: {message} (服务器: {server})')

# 如果有可选字段
records = [
    'INFO|启动服务',
    'ERROR|连接失败|10.0.0.1',
    'WARN|内存使用率高|85%',
]

for record in records:
    parts = record.split('|')
    level, msg = parts[0], parts[1]
    extra = parts[2] if len(parts) > 2 else None
    print(f'[{level}] {msg}', end='')
    if extra:
        print(f' → {extra}')
    else:
        print()

# 用解包实现滑动窗口
def sliding_triples(lst):
    """生成连续三个元素的滑动窗口"""
    it = iter(lst)
    try:
        a, b, c = next(it), next(it), next(it)
    except StopIteration:
        return
    yield (a, b, c)
    for x in it:
        a, b, c = b, c, x  # 优雅地滑动！
        yield (a, b, c)

data = [1, 2, 3, 4, 5, 6, 7]
for triple in sliding_triples(data):
    print(triple)
# (1, 2, 3)
# (2, 3, 4)
# (3, 4, 5)
# (4, 5, 6)
# (5, 6, 7)


# 更通用的滑动窗口（使用解包）
def sliding_window(lst, n):
    """生成大小为n的滑动窗口"""
    it = iter(lst)
    window = tuple(next(it) for _ in range(n))
    yield window
    for x in it:
        window = window[1:] + (x,)  # 或 (*window[1:], x)
        yield window

for window in sliding_window([1, 2, 3, 4, 5, 6, 7], 3):
    print(window)

# 错误一：变量数不匹配
# a, b = (1, 2, 3)  # ValueError: too many values to unpack

# 错误二：尝试解包不可迭代对象
# a, b = 42  # TypeError: cannot unpack non-iterable int object

# 错误三：*变量只能出现一次
# *a, *b = [1, 2, 3]  # SyntaxError

# 错误四：单个*变量需要赋值目标
# *a = [1, 2, 3]  # SyntaxError
*a, = [1, 2, 3]  # 正确：加逗号
print(a)  # [1, 2, 3]

# 错误五：混淆解包和多重赋值
# 以下两个完全不同：
a, b = 1, 2     # 解包赋值：右边是元组(1,2)
a = b = 1       # 链式赋值：a和b都指向1

# 解包可以在嵌套结构中使用
# 但要注意括号和逗号的使用

# 嵌套列表的解包
(a, b), (c, d) = [(1, 2), (3, 4)]
print(a, b, c, d)  # 1 2 3 4

# 混合*的嵌套解包
first, (*middle, last) = [(1, 2, 3, 4), (5, 6, 7, 8)]
print(first)   # (1, 2, 3, 4)
# 注意：上面的写法可能有歧义，建议明确写出

# 解包优先用简单的匹配
data = [1, 2, 3, 4, 5]
a, b, *c = data  # 清晰
# vs
(a, b), *c = [(1, 2), 3, 4, 5]  # 容易混淆

# Python解包语法速查

# 1. 基本解包：变量数 = 元素数
a, b, c = (1, 2, 3)         # a=1, b=2, c=3

# 2. 星号收集：*变量收集剩余为列表
a, *b = (1, 2, 3)            # a=1, b=[2, 3]
*a, b = (1, 2, 3)            # a=[1, 2], b=3
a, *b, c = (1, 2, 3, 4)      # a=1, b=[2, 3], c=4

# 3. 忽略值：用_或*_
a, _, c = (1, 2, 3)          # a=1, c=3, 2被忽略
a, *_, c = (1, 2, 3, 4, 5)   # a=1, c=5, 中间被忽略

# 4. 嵌套解包
(a, b), (c, d) = ((1, 2), (3, 4))  # a=1,b=2,c=3,d=4
name, (math, eng) = ('小明', (85, 92))

# 5. 只能有一个*变量
# *a, *b = ...  # 错误！

# 6. 函数参数解包
def f(*args): pass   # args是元组
f(*[1, 2, 3])        # 列表解包为参数
def g(**kwargs): pass  # kwargs是字典
g(**{'a': 1})        # 字典解包为关键字参数

# 7. 合并用*
combined = [*list1, *list2]          # 合并列表
merged = {**dict1, **dict2}          # 合并字典