ast.unparse在Python 3.9+中虽为正式API，但常因输入AST节点缺失lineno/col_offset字段、含不支持语法（如match/case）、误用3.10+参数或ctx错误而报错。
ast.unparse 在 Python 3.9 中已作为正式 API 加入标准库，无需额外安装或 monkey patch —— 它能直接将 ast.AST 节点转回可读、可运行的 Python 源码字符串，但行为受节点完整性与 Python 版本限制约束。
为什么 ast.unparse 在 3.9+ 可用却常报错？
根本原因不是函数不存在，而是输入 AST 节点缺失关键字段（如 lineno、col_offset）或包含未被支持的语法结构（如带装饰器的类方法、某些推导式嵌套）。Python 3.9 的 ast.unparse 不会自动补全位置信息，也不会降级处理新语法。
常见错误现象：
-
AttributeError: 'Expr' object has no attribute 'value'（实际是字段名不匹配，比如用了旧 AST 构造方式） -
TypeError: unparse() takes exactly 1 argument (2 given)（误传了source_roundtrip=True等 3.10+ 参数） - 输出空字符串或意外缩进，因节点未设置
end_lineno/end_col_offset（3.9 不依赖这些字段，但若手动设置了错误值仍可能干扰）
构造兼容 Python 3.9 的 AST 节点再调用 unparse
必须确保节点由 ast.parse() 解析而来，或使用 ast.* 工厂函数（如 ast.Expr、ast.Return）并显式赋值必要字段。不能直接修改 __dict__ 或跳过类型检查。
实操建议：
- 优先用
ast.parse("x = 1", mode="exec")得到完整 AST，再用ast.copy_location(new_node, ref_node)复制位置信息 - 手动构建节点时，至少设置
lineno=1和col_offset=0（即使不参与格式化，3.9 内部逻辑仍会访问） - 避免在 3.9 中使用
ast.unparse(node, source_roundtrip=True)—— 该参数直到 3.10 才引入 - 对表达式节点，用
ast.Expression(body=...)包裹后再传给unparse，否则可能丢括号或换行
示例：
import ast
node = ast.parse("a + b", mode="eval")
# ✅ 正确：直接 unpase eval 模式结果
print(ast.unparse(node.body)) # 输出: 'a + b'
<p>assign = ast.Assign(
targets=[ast.Name(id="x", ctx=ast.Store())],
value=ast.Constant(value=42),
lineno=1,
col_offset=0
)</p><h1>✅ 正确：手动设 lineno/col_offset</h1><p>print(ast.unparse(assign)) # 输出: 'x = 42'
</p>
哪些语法在 Python 3.9 的 unparse 中不被支持？
不是所有合法 Python 3.9 语法都能 round-trip。以下结构会导致 NotImplementedError 或生成无效代码：
- 带
match/case的模式匹配（Python 3.10+ 引入，3.9 的unparse完全不识别Match节点） - 带
yield表达式的生成器推导式（(x for x in y if yield z)） - 部分带注解的变量声明（如
a: int = 1中的AnnAssign节点虽存在，但 3.9 的unparse对simple=0场景支持不稳定） - 使用
__future__启用的新语法（如from __future__ import annotations不影响unparse，但若 AST 中含未解析的字符串化注解，可能漏引号）
判断是否支持的最快方式：ast.unparse(node) 不抛异常且输出符合预期，即为安全；否则需降级为手动拼接或升级 Python 版本。
最易被忽略的是：AST 节点的 ctx 字段（如 Load/Store/Del）必须正确，unparse 不做校验，错用会导致静默生成错误代码（例如把 ast.Name(ctx=ast.Load()) 当作赋值目标），这类问题只在运行时暴露。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
