Python divmod() 函数（实战总结）

Python divmod() 函数：一个看似简单却充满智慧的内置函数

在 Python 的内置函数中，divmod() 可能不是最常被提起的那一个，但它却像一把小巧但锋利的瑞士军刀，能在多个场景下派上大用场。如果你正在学习基础运算，或者在处理整数除法、取余、时间换算、进制转换等任务，那么掌握 divmod() 函数将让你的代码更简洁、更高效。

本文将带你从零开始，全面理解这个函数的用法、原理和实际应用场景，不讲虚的，只讲你真正能用上的内容。

什么是 Python divmod() 函数？

divmod() 是 Python 内置函数之一，它的作用是同时返回两个结果：两个数相除的商（整数除法结果）和余数（取模结果）。

它的语法非常简洁：

divmod(a, b)

其中：

• a 是被除数
• b 是除数
• 返回值是一个元组 (商, 余数)

举个例子：

result = divmod(17, 5)
print(result)

输出：

(3, 2)

解释：17 除以 5，商是 3，余数是 2。这正是我们平时手算的结果。

💡 小贴士：divmod() 的设计灵感来源于数学中的“带余除法”：a = b * q + r，其中 q 是商，r 是余数，且 0 ≤ r < |b|。

与普通除法的区别：为什么需要 divmod()？

在 Python 中，我们通常用 // 做整除，用 % 做取余。比如：

a = 17
b = 5

quotient = a // b   # 3
remainder = a % b  # 2

看起来和 divmod() 的效果一样，对吧？那为什么还要用 divmod()？

答案是：效率和代码清晰度。

当你要同时获取商和余数时，使用 divmod() 只需要一次计算，而分别用 // 和 % 则会重复计算除法过程。

实际对比示例

a = 17
b = 5

q1 = a // b   # 3
r1 = a % b    # 2

print(f"商：{q1}, 余数：{r1}")

a = 17
b = 5

q2, r2 = divmod(a, b)

print(f"商：{q2}, 余数：{r2}")

虽然两个结果一样，但 divmod() 一次完成，代码更简洁，也更符合“一次运算，两个结果”的逻辑。

✅ 推荐：当你需要同时获取商和余数时，优先使用 divmod()，而不是分开写 // 和 %。

实际应用场景：从时间换算到进制转换

时间换算：将秒数转为时:分:秒

这是 divmod() 最经典的应用之一。假设你有一个总秒数，想把它转换成“时:分:秒”的格式。

total_seconds = 3725

minutes, seconds = divmod(total_seconds, 60)

hours, minutes = divmod(minutes, 60)

print(f"{hours} 小时 {minutes} 分钟 {seconds} 秒")

输出：

1 小时 2 分钟 5 秒

🎯 说明：divmod() 像是“分层拆解”工具。先拆出秒，再从分钟里拆出小时，层层递进，逻辑清晰。

进制转换：十进制转二进制

虽然 Python 有 bin() 函数，但我们可以手动实现，用 divmod() 来理解底层原理。

def decimal_to_binary(n):
    binary = ""
    while n > 0:
        # 每次除以 2，得到商和余数
        n, remainder = divmod(n, 2)
        # 余数是当前位的二进制值（0 或 1）
        binary = str(remainder) + binary
    return binary

print(decimal_to_binary(13))  # 输出：1101

🔍 解释：13 ÷ 2 = 6 余 1 → 6 ÷ 2 = 3 余 0 → 3 ÷ 2 = 1 余 1 → 1 ÷ 2 = 0 余 1
从下往上读余数：1101，正是 13 的二进制表示。

这个例子展示了 divmod() 在算法实现中的核心地位——它是“除法迭代”的天然伴侣。

处理负数：你需要注意的边界情况

divmod() 在处理负数时，行为和你直觉可能不一致。我们来测试一下：

print(divmod(17, 5))    # (3, 2)

print(divmod(17, -5))   # (-4, -3)

print(divmod(-17, 5))   # (-4, 3)

print(divmod(-17, -5))  # (3, -2)

输出：

(3, 2)
(-4, -3)
(-4, 3)
(3, -2)

⚠️ 注意：Python 的整数除法采用“向下取整”策略（floor division），即向负无穷方向取整。

例如：17 // -5 = -4，因为 -4 比 -3.4 更小。所以余数 17 % -5 = -3，才能满足 17 = (-5) * (-4) + (-3)。

这和某些语言（如 C）的行为不同，但 Python 的设计保证了恒等式成立：

a == b * (a // b) + (a % b)

因此，divmod() 的结果始终满足这个数学关系。

返回值是元组：如何解包使用？

divmod() 返回的是一个元组，你可以通过解包的方式提取两个值。

result = divmod(25, 7)

quotient, remainder = result
print(f"商：{quotient}, 余数：{remainder}")

或者直接在调用时解包：

quotient, remainder = divmod(25, 7)
print(f"商：{quotient}, 余数：{remainder}")

✅ 小技巧：如果只关心其中一个值，可以用 _ 忽略不需要的部分：

_, remainder = divmod(25, 7)
print(f"余数是：{remainder}")  # 输出：4

与其他函数的对比：divmod() vs divmod() vs divmod()

我们来做一个简要对比，帮助你选择合适的工具。

📌 总结：divmod() 不是替代 // 和 % 的工具，而是在需要同时获取两个结果时的更优选择。

常见错误与注意事项

错误 1：除数为 0

divmod(10, 0)

会抛出异常：

ZeroDivisionError: integer division or modulo by zero

❌ 一定要确保除数 b 不为 0。

错误 2：参数类型错误

divmod() 只接受数字类型（int、float），不支持字符串。

divmod("10", 2)  # 报错

✅ 提示：如果输入是字符串，先用 int() 或 float() 转换。

错误 3：解包时数量不匹配

q, r, extra = divmod(10, 3)  # 报错：不是两个值

divmod() 总是返回两个元素，所以只能解包为两个变量。

总结：为什么你应该掌握 Python divmod() 函数？

divmod() 看似简单，实则精妙。它不仅是数学运算的工具，更是编程思维的体现——一次运算，两个结果，不重复计算，代码更优雅。

无论你是初学者还是中级开发者，只要你在处理整数除法、时间换算、进制转换、循环迭代等任务，divmod() 都能成为你代码中的“加速器”。

记住：当你要同时获取商和余数时，别再写两行代码了，直接用 divmod()，它更高效，也更 Pythonic。

💬 最后送你一句编程哲学：“少写一行代码，就少一个出错的机会。”
用对函数，就是对代码负责。

希望这篇文章能让你真正理解并爱上这个低调却强大的 Python divmod() 函数。下期再见！