如何使用 Cython 正确编译含 Typer 注解的 Python 程序-Python教程-PHP中文网

Cython 默认启用注解类型检查，而 Typer 的 typer.Argument/typer.Option 等对象并非运行时字符串，导致编译后报错 TypeError: Expected str, got ArgumentInfo；禁用 annotation_typing 并显式指定语言级别可解决该问题。

cython 默认启用注解类型检查，而 typer 的 `typer.argument`/`typer.option` 等对象并非运行时字符串，导致编译后报错 `typeerror: expected str, got argumentinfo`；禁用 `annotation_typing` 并显式指定语言级别可解决该问题。

Cython 将 Python 源码编译为 C 代码时，默认行为与 CPython 解释器存在关键差异：它会对类型注解进行静态验证（尤其在 language_level=3 下），而 Typer 的参数声明（如 typer.Argument(None)）本质是运行时构造的配置对象，并非字面量 str。当 Cython 尝试将 key_id: str = typer.Argument(None) 中的 str 注解与右侧 ArgumentInfo 实例做类型匹配时，即触发 TypeError。

✅ 正确解决方案是在源文件顶部添加 Cython 编译指令，显式关闭注解类型检查并固定语言级别：

# main.py
#cython: annotation_typing = False
#cython: language_level = 3

import typer

app = typer.Typer()

@app.command()
def show_code(
    key_id: str = typer.Argument(None),
    issuer_name: str = typer.Option(None),
    e: bool = typer.Option(False, help="Show TOTP code of a key outside key file.")
):
    # your logic here
    pass

⚠️ 注意事项：

提示词大师-python版

图片提示词生成器？不止如此。马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。输入「新手指南」查看完整功能介绍

下载

#cython: 指令必须位于文件开头（前几行，无空行隔开），否则会被忽略；
language_level=3 明确启用 Python 3 语义（如 print 为函数、str 为 Unicode），避免兼容性警告；
annotation_typing = False 是关键：它禁用对注解类型与默认值一致性校验，使 Typer 等依赖动态注解的库可正常工作；
不建议依赖 --embed 后手动调用 gcc —— 推荐改用标准 setup.py 构建流程，更可靠且便于管理依赖：

# setup.py
from setuptools import setup
from Cython.Build import cythonize
from Cython.Distutils import build_ext
import numpy

setup(
    ext_modules = cythonize("main.py", compiler_directives={'annotation_typing': False, 'language_level': 3}),
    cmdclass = {'build_ext': build_ext},
)

构建命令：

python setup.py build_ext --inplace
# 或生成独立可执行文件（需额外配置）
python setup.py build_ext --inplace && gcc -Os $(python3-config --includes) main.c -o pyauth $(python3-config --ldflags) -lpython3.11m

? 总结：Cython 不是“透明替换解释器”的工具，而是带有自身语义规则的编译器。涉及框架级注解（Typer、Pydantic、FastAPI 等）时，务必查阅其 Cython 兼容性文档，并通过 compiler_directives 或源码指令显式配置行为。相比 PyInstaller，Cython 生成的二进制体积更小、启动更快，但需更精细的构建控制。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！