timeit.timeit() 默认在空作用域执行，变量不可见，需用 globals 或 setup 注入；多行语句必须用三引号包裹且缩进合法；number 是单轮重复次数，repeat 控制轮数，默认返回5个总耗时；time.time() 精度低、干扰大，不适用于精确性能测试。
timeit.timeit() 的基本调用方式和陷阱
直接用 timeit.timeit() 测单行语句最简单，但默认在空作用域里执行，所有变量都不可见——这是新手最常踩的坑。比如想测 a = [1, 2, 3]; sum(a)，写成 timeit.timeit("sum(a)", number=100000) 会报 NameError: name 'a' is not defined。
解决办法是用 setup 参数提前注入变量，或者改用 globals 参数传入当前作用域：
import timeit
a = [1, 2, 3]
# ✅ 正确：通过 globals 注入
timeit.timeit("sum(a)", globals=globals(), number=100000)
<h1>✅ 或者用 setup 字符串（注意缩进和换行）</h1><p>timeit.timeit("sum(a)", setup="a = [1, 2, 3]", number=100000)</p>
别用 timeit.timeit(lambda: sum(a), ...) —— lambda 本身有额外开销，测的不是目标语法，而是函数调用+lambda创建成本。
测试多行语句必须用 triple-quoted string
测 if/for/def 等多行结构时，不能把代码拆成多个字符串拼接，必须用三引号包裹完整代码块，且缩进要合法（Python 解析器会校验）。常见错误是漏掉冒号、缩进不一致，导致 IndentationError 或 SyntaxError。
示例：测列表推导 vs map 的性能差异
# ✅ 正确：三引号 + 合法缩进
timeit.timeit("""
xs = list(range(100))
[y * 2 for y in xs]
""", number=100000)
<h1>❌ 错误：用 \n 拼接，缩进易错且难维护</h1><p>timeit.timeit("xs = list(range(100))\n[y * 2 for y in xs]", ...)</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2506" title="Python 3.14.2"><img
src="https://img.php.cn/upload/manual/001/221/864/6a696c31dfa4a111.webp" alt="Python 3.14.2" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2506" title="Python 3.14.2" class="overflowclass">Python 3.14.2</a>
<p class="overflowclass">Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2506" title="Python 3.14.2" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
如果逻辑复杂，建议先在 REPL 里跑通再贴进 timeit；setup 部分也支持多行，同样需保证语法正确。
number 和 repeat 参数的实际影响
number 是单次运行重复多少次；repeat（默认 5）是整个 number 循环跑几轮，最终返回一个长度为 repeat 的耗时列表。多数人只关心最小值（排除系统抖动），而不是平均值。
- 默认
repeat=5，结果是 5 个总耗时（单位秒），不是单次平均 - 想看单次平均耗时，得手动除：
min(times) / number -
number太小（如 1）会导致计时误差主导结果；太大又可能触发 GC 干扰，一般从 10000 起调，根据量级调整 - 用
timeit.Timer(...).autorange()可自动找合理number，但返回的是(number, time)元组，需自己解包
为什么不能用 time.time() 替代 timeit？
time.time() 返回系统时间戳，精度低（尤其 Windows 上只有 ~15ms）、受系统调度干扰大，测短操作（timeit 底层用 time.perf_counter()，精度高、单调递增、不受系统时钟调整影响。
更关键的是，timeit 自动禁用 GC（避免垃圾回收打断计时），并多次运行取最小值来压制瞬时波动。手动实现这些细节极易出错：
# ❌ 危险：没关 GC，没处理 warmup，没去噪
import time
start = time.time()
for _ in range(100000):
sum([1, 2, 3])
end = time.time()
<h1>✅ timeit 已内置这些保障</h1><p>timeit.timeit("sum([1, 2, 3])", number=100000)</p>
真正需要手动控制的场景极少，比如测带副作用的代码（如修改全局状态），这时才考虑绕过 timeit，但得自己补全所有防护措施。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
