code 模块是 Python 标准库中用于交互式解释器嵌入和自定义解释器交互环境的模块。它提供了底层接口，可在程序内部启动一个交互式 shell，用于调试、教学或 REPL 工具开发。

这个模块常见于调试器、远程控制台、图形界面的嵌入终端，或你想在程序运行时打开一个交互式命令行的场景中。

常见应用场景：（1）在程序运行中启动一个交互式解释器进行调试。（2）创建带预设环境的 REPL（如自动导入模块）。（3）在命令行工具或 GUI 工具中集成 Python shell。（4）搭建简化版 Python 解释器。（5）构建教学或演示用交互环境。

核心概念

1、InteractiveConsole 类一个类似 code.InteractiveInterpreter 的子类，提供支持交互式输入的解释器环境，适合嵌入到终端。

2、InteractiveInterpreter 类基本解释器实现，提供代码执行能力，但不管理输入提示或代码缓存。

3、interact() 函数使用 InteractiveConsole 快速启动一个交互式 shell。

4、compile_command() 函数判断一段代码是否完整（是否可以执行），用于多行代码输入的支持。

应用举例

例 1：快速启动一个交互式解释器

import code

code.interact()

例 2：带预设变量的交互式解释器

import code

banner = "欢迎进入自定义 REPL"local_vars = {"name": "Python", "version": 3.12}code.interact(banner=banner, local=local_vars)

例 3：通过 InteractiveConsole 执行多行输入

import code

console = code.InteractiveConsole()console.push("for i in range(3):")console.push("    print(i)")console.push("")  # 空行表示代码块结束

例 4：作为调试入口，在程序任意位置调用交互式解释器

import code

def debug_shell():    print("进入调试模式")    code.interact(local=dict(globals(), **locals()))

x = 42debug_shell()  # 可访问 x 的值

例 5：判断代码是否完整

from code import compile_command

print(compile_command("for i in range(5):"))  # None（不完整）print(compile_command("    print(i)"))         # Noneprint(compile_command(""))                     # 代码完整，可执行

常用函数速览

code.InteractiveConsole([locals])

创建一个支持交互式输入的 Python 控制台。参数：locals：字典形式的局部变量命名空间（默认使用 __main__ 的）返回：InteractiveConsole 实例，可通过 .push() 逐行传入代码

code.InteractiveInterpreter([locals])

创建基础解释器，执行 Python 语句但不管理输入状态。参数：locals：解释器上下文的局部变量环境返回：InteractiveInterpreter 实例，适合自定义代码执行环境

code.compile_command(source, filename='<input>', symbol='single')

将代码编译为可执行对象，支持判断代码是否完整。参数：source：字符串形式的 Python 代码filename：虚拟文件名（用于调试）symbol：执行模式，通常为 'single' 或 'exec'返回：code 对象（若代码完整），否则返回 None

code.interact([banner], [readfunc], [local])

快速启动一个交互式解释器（REPL）。参数：banner：启动欢迎语readfunc：自定义输入函数（一般忽略）local：REPL 中可用的变量字典（如 locals()）返回：无（交互式命令行，直到用户退出）

补充说明

1、code.interact() 是最常用的接口，适用于快速调试或教学。

2、使用 InteractiveConsole.push(line) 可以逐行输入代码（如 GUI 工具中实现交互窗口）。

3、compile_command() 是判断“代码是否结束”的关键，适用于构建支持多行语句的编辑器或交互工具。

4、模块中不包含自动补全、命令历史等功能，如需支持可结合 readline 使用。

5、适合嵌入到 CLI 工具、Web 终端（如 Jupyter）、游戏控制台、IDE 等。

更多相关技术内容咨询欢迎前往并持续关注好学星城论坛了解详情。

想高效系统的学习Python编程语言，推荐大家关注一个微信公众号：Python编程学习圈。每天分享行业资讯、技术干货供大家阅读，关注即可免费领取整套Python入门到进阶的学习资料以及教程，感兴趣的小伙伴赶紧行动起来吧。