Cython 默认启用注解类型检查，而 Typer 的 Argument/Option 等对象并非纯类型（如 str），直接用作参数注解会触发 TypeError；通过禁用 annotation_typing 并显式指定 language_level=3 即可修复。
cython 默认启用注解类型检查，而 typer 的 `argument`/`option` 等对象并非纯类型（如 `str`），直接用作参数注解会触发 `typeerror`；通过禁用 `annotation_typing` 并显式指定 `language_level=3` 即可修复。
当你使用 Cython 将基于 Typer 的 Python 脚本（如 main.py）编译为独立二进制时，即使脚本在 python3 main.py 下完全正常，编译后却报错：
TypeError: Expected str, got ArgumentInfo
根本原因在于：Cython 默认对函数参数注解执行静态类型验证。Typer 中的写法：
def show_code(
key_id: str = typer.Argument(None),
issuer_name: str = typer.Option(None),
e: bool = typer.Option(False, help="...")
):
表面上 key_id: str 声明了类型，但实际 typer.Argument(None) 返回的是 ArgumentInfo 实例——它不是 str 类型，而是一个配置对象。Cython 在嵌入模式（--embed）下会严格校验该注解是否与右侧默认值类型兼容，从而在运行时（即 init main 阶段）抛出异常。
✅ 正确解决方案是关闭 Cython 的注解类型检查，并在源文件顶部添加编译指令：
# cython: annotation_typing = False # cython: language_level = 3
⚠️ 注意：这两行必须是文件最开头的注释（前面不能有空行或 shebang），且格式为 # cython: 后紧跟空格、指令名、等号、值（无引号）。language_level=3 显式声明使用 Python 3 语义（推荐始终显式设置，避免 FutureWarning）。
完整修复步骤如下：
-
修改 main.py 开头（确保是第 1–2 行）：
# cython: annotation_typing = False # cython: language_level = 3 import typer # ... 其余代码
-
重新生成 C 文件：
cython -3 --embed main.py
-
编译为二进制（建议使用 python3-config 保证一致性）：
PYTHONLIBVER=$(python3-config --ldflags | grep -o 'python[0-9.]\+[a-z]*') \ gcc -Os $(python3-config --includes) main.c -o pyauth \ $(python3-config --ldflags) -l$PYTHONLIBVER
? 进阶建议：
-
使用 setup.py + setuptools 管理构建更可靠（避免手动拼接编译命令）：
# setup.py from setuptools import setup from Cython.Build import cythonize from Cython.Distutils import build_ext from distutils.core import Extension extensions = [Extension("main", ["main.py"])] setup( ext_modules = cythonize(extensions, compiler_directives={'annotation_typing': False, 'language_level': 3}), options={'build_ext': {'inplace': True}} )然后运行 python setup.py build_ext --inplace。
若仍需最小体积与启动速度，可对比 cython + gcc（约数 MB）与 pyinstaller --onefile --strip（虽大但更鲁棒）；Cython 方案优势在于极致轻量和可控性，适合部署在资源受限环境。
总结：Cython 不是“黑盒打包器”，而是带类型语义的 Python 编译器。面对框架（如 Typer、Click、Pydantic）中大量使用 Callable/object 类型注解的场景，务必通过 annotation_typing = False 关闭其侵入式类型校验，才能兼顾灵活性与编译可行性。
