CPython 自带 IDE —— IDLE 完全指南：编辑器、Shell、调试器与 idlelib 实现解析

IDLE（Integrated Development and Learning Environment）是 CPython 随发布包一起分发的官方集成开发与学习环境，源码位于仓库的 Lib/idlelib/ 目录。本文以标准库参考中 IDLE 章节为骨架，逐项解析其菜单体系、编辑导航机制、代码执行模型、命令行用法与偏好设置，并结合 idlelib 源码给出实现层面的印证，帮助读者把 IDLE 当作日常 Python 学习、tkinter 原型开发与调试工具用透。

一、IDLE 概览：功能与实现架构

IDLE 是 Python 的官方 IDE，具备以下核心特性：

• 跨平台：在 Windows、Unix 和 macOS 上行为基本一致；
• Python Shell 窗口：交互式解释器，对代码输入、输出与错误消息进行彩色高亮；
• 多窗口文本编辑器：支持多级撤销、Python 语法着色、智能缩进、calltip（参数提示）、自动补全等功能；
• 搜索能力：任意窗口内搜索、编辑器窗口内替换、跨多文件搜索（grep）；
• 调试器：支持持久化断点、单步执行、查看全局与局部命名空间；
• 配置系统：字体、配色、按键、启动窗口等均可通过对话框自定义。

IDLE 应用本身由 idlelib 包实现，其模块划分可参考 Lib/idlelib/README.txt，该文件同时标注了每个菜单项对应的实现模块，例如：

• File 菜单各项主要由 iomenu.py（打开/保存/打印）、filelist.py、browser.py（模块浏览器）实现；
• 编辑功能分布在 editor.py、undo.py（撤销栈）、searchengine.py/search.py/replace.py/grep.py（查找/替换/跨文件搜索）；
• Shell 与运行相关集中在 pyshell.py、run.py、runscript.py；
• 调试相关为 debugger.py、debugger_r.py、stackviewer.py。

除 Lib/idlelib/README.txt 顶部 "Startup" 一节列出的启动文件外，idlelib 其余代码被视为"私有"实现（特性变更可在维护版本中回移，遵循 PEP 434），因此开发者不应依赖其内部 API。

二、启动 IDLE：命令行用法详解

IDLE 的通用启动命令是（Doc/library/idle.rst 中的 idle 程序名）：

python -m idlelib [options] [file ...]

其入口实现位于 Lib/idlelib/main.py：它只是调用 idlelib.pyshell.main()。参数解析的真实逻辑在 Lib/idlelib/pyshell.py 的 usage_msg（约第 1468 行起）与 main() 函数中，通过 getopt.getopt(sys.argv[1:], "c:deihnr:st:") 实现。

支持的全部选项如下：

选项	含义	源码处理要点
-c <command>	在 Shell 窗口中运行指定 Python 命令，例如 -c "print('Hello, World!')"（Windows 下外层必须用双引号）	置 cmd 并强制打开 Shell
-d	启用调试器并打开 Shell 窗口	置 debug 标志
-e	打开编辑器窗口	置 enable_edit
-i	打开 Shell 窗口	置 enable_shell
-r <file>	在 Shell 窗口中运行指定文件	校验文件存在，脚本路径将进入 sys.argv[0]
-s	在打开 Shell 前运行启动文件（见下文 IDLESTARTUP/PYTHONSTARTUP）	置 startup 标志
-t <title>	设置 Shell 窗口标题	赋给 PyShell.shell_title
-h	打印合法选项组合的帮助信息后退出	输出 usage_msg
-	在 Shell 窗口中读取并执行标准输入；必须是参数中的最后一个	从 sys.stdin.read() 读取命令
-n	单进程模式运行（已弃用，见下文"无子进程运行"）	打印弃用警告

参数与 sys.argv 的映射规则（Lib/idlelib/pyshell.py 第 1579 行起有对应实现）：

• 使用 - 时，所有参数放入 sys.argv[1:]，sys.argv[0] 置为 ''；
• 使用 -c 时，sys.argv[0] 置为 '-c'，参数放入 sys.argv[1:]；
• 使用 -r 时，sys.argv[0] 置为脚本文件名，其余参数放入 sys.argv[1:]；
• 上述三种情况均不会打开编辑器窗口（即使"Options"对话框默认设置要打开编辑器）；
• 其余情况下，参数按待编辑文件打开，文件所在目录会被插入 sys.path 头部以便模块导入（若完全没有位置参数，则把当前工作目录插入 sys.path）。

官方帮助信息中的综合示例（源码 usage_msg 原样提供）：

idle                      # 按配置打开编辑器或 Shell
idle foo.py foobar.py     # 编辑两个文件（若配置为启动 Shell 也会打开 Shell）
idle -est "Baz" foo.py    # 先跑启动文件，再编辑 foo.py，并以 "Baz" 为题打开 Shell
idle -c "import sys; print(sys.argv)" "foo"   # sys.argv[0]=='-c', sys.argv[1]=='foo'
idle -d -s -r foo.py "Hello World"            # 跑启动脚本、启用调试器并运行 foo.py
echo "import sys; print(sys.argv)" | idle - "foobar"   # 从 stdin 读入命令执行

注意各开关存在隐含关系：-c、-r、-d、-s、-t 均隐含 -i（强制出现 Shell 窗口）；默认启动窗口类型则由配置项 General > editor-on-startup（Lib/idlelib/config-main.def 默认值为 0，即启动 Shell）结合命令行共同决定。

三、菜单全景：两类主窗口的完整功能清单

IDLE 有两类主窗口——Shell 窗口与编辑器窗口，可同时打开多个编辑器窗口。Windows/Linux 下每个窗口有自己的顶层菜单；macOS 上则只有一个应用级菜单，随当前选中窗口动态切换，且按 Apple 规范调整了若干条目位置。用于"Find in Files"输出等的输出窗口是编辑器窗口的亚型：顶层菜单相同，但默认标题与右键菜单不同。

各菜单归属窗口类型如下（全部逐项继承自参考文档）：

File 菜单（Shell 与 Editor 共有）

• New File：新建文件编辑窗口；
• Open...：通过打开对话框开启已有文件；
• Open Module...：按模块名打开（在 sys.path 中搜索）；
• Recent Files：最近打开文件列表，单击即打开；
• Module Browser：以树状结构展示当前编辑器文件中的函数、类与方法；在 Shell 中需先导入模块；
• Path Browser：以树状展示 sys.path 目录、模块、函数、类与方法；
• Save：保存到关联文件；自打开/上次保存后改动过的窗口，标题前后会带 *；无关联文件时退化为 Save As；
• Save As...：换名保存并成为新关联文件（若文件管理器隐藏扩展名，Python 文件与文本文件会自动补 .py/.txt；macOS Aqua 下所有文件补 .py）;
• Save Copy As...：另存一份而不改变原关联文件；
• Print Window：向默认打印机打印当前窗口；
• Close Window：关闭当前窗口（编辑器未保存先询问；Shell 未执行完毕询问是否终止执行）；在 Shell 中调用 exit() 或 close() 同样关闭 Shell；若这是唯一窗口则同时退出 IDLE；
• Exit IDLE：关闭所有窗口并退出（询问未保存的编辑窗口）。

Edit 菜单（Shell 与 Editor 共有）

• Undo / Redo：撤销/重做当前窗口最近修改，最多可撤销 1000 次更改；
• Select All：全选当前窗口内容；
• Cut / Copy / Paste：系统剪贴板操作（右键上下文菜单同样可用）；
• Find...：带多种选项的搜索对话框；Find Again 重复上次搜索；Find Selection 搜索当前选中串；Find in Files... 跨文件搜索，结果放入新的输出窗口；Replace... 查找替换对话框；
• Go to Line：光标移到指定行并滚动可见；超过文件末尾的请求定位到末尾；清除选区并刷新行/列状态栏；
• Show Completions：打开可滚动的名字补全列表（详见下文"自动补全"）；
• Expand Word：把已输入前缀扩展为窗口中出现的完整单词，可反复触发切换候选；
• Show Call Tip：在未闭合括号处显示函数参数提示；
• Show Surrounding Parens：高亮配对的括号。

Format 菜单（仅 Editor 窗口）

• Format Paragraph：重排光标所在文本块；避开代码行（规则见下文"Format block"）；
• Indent Region / Dedent Region：把选中行按缩进宽度（默认 4 空格）整体右移/左移；
• Comment Out Region / Uncomment Region：在选中行首插入 ## / 移除行首的 # 或 ##；
• Tabify Region：把行首连续空格转成制表符（官方建议仍用 4 空格缩进）；Untabify Region 把所有制表符转为空格；
• Toggle Tabs：对话框切换"空格缩进/制表符缩进"；
• New Indent Width：修改缩进宽度（Python 社区接受的默认值是 4 空格）；
• Strip Trailing Whitespace：对每行应用 str.rstrip 去掉行尾空白（包括多行字符串内部）；除 Shell 窗口外还会移除文件末尾多余的换行。

对应实现位于 Lib/idlelib/format.py，其中可重排段落的最大宽度默认 72 列，定义于 Lib/idlelib/config-extensions.def 的 [FormatParagraph] max-width= 72，可在设置对话框的 Window 页修改。

Run 菜单（仅 Editor 窗口）

• Run Module（F5）：先执行 Check Module 语法检查，无错则重启 Shell 以清空环境，再执行模块，输出显示在 Shell 窗口（输出需用 print 或 write）；执行完毕后 Shell 获得焦点并显示提示符，可交互式探查执行结果——这与命令行执行 python -i file 类似；
• Run... Customized：同 Run Module，但允许自定义运行：Command Line Arguments 会扩展 sys.argv（如同命令行传入）；也可选择不重启 Shell 而在当前环境中运行；
• Check Module：语法检查当前编辑器模块；未保存时会按设置对话框 General 页的选择提示保存或自动保存；有语法错误时在编辑器中近似标出错误位置；
• Python Shell：打开或唤醒 Python Shell 窗口。

上述三项分别由 runscript.ScriptBinding 的 check_module_event、run_module_event、run_custom_event 驱动（见 Lib/idlelib/README.txt 的菜单映射）。

Shell 菜单（仅 Shell 窗口）

• View Last Restart：滚动到最近一次 Shell 重启处；
• Restart Shell：重启 Shell 以清空环境、重置显示与异常处理；
• Previous History / Next History：在历史命令中按与当前输入匹配的条件前后翻找；
• Interrupt Execution：中断正在运行的程序。

Debug 菜单（仅 Shell 窗口）

• Go to File/Line：解析光标所在行及其上一行中的"文件名+行号"，据此打开对应文件并跳转——用于查看异常 traceback 与 Find in Files 结果引用的源码行（Shell 与输出窗口右键菜单也有）；
• Debugger（开关）：开启后，Shell 中输入或从编辑器运行的代码都在调试器下执行；在编辑器中可用右键菜单设置断点。官方提示该功能尚不完整、带实验性质；
• Stack Viewer：把最近一次异常的堆栈回溯以树控件展示，可访问局部与全局变量；
• Auto-open Stack Viewer：开关——遇到未处理异常时是否自动打开堆栈查看器。

调试相关的进程内/进程外实现分别见 Lib/idlelib/debugger.py（GUI 端）与 Lib/idlelib/debugger_r.py（远端运行进程端）。

Options 菜单（Shell 与 Editor 共有）

• Configure IDLE：打开配置对话框，可修改字体、缩进、按键、文本配色主题、启动窗口与尺寸、附加帮助源、扩展等（macOS 上在应用菜单选 Preferences）。多数配置项作用于所有窗口或未来打开的窗口；
• Show/Hide Code Context（仅 Editor）：在窗口顶部显示已滚出视野的块级代码（class/def/if 等）的上下文行。面板按需伸缩，最多显示行数在 Configure IDLE 对话框设置，默认 15 行（源码见 Lib/idlelib/config-extensions.def 的 [CodeContext] maxlines= 15）；无上下文且功能开启时显示一条空行；单击上下文行可让该行滚回编辑器顶部；面板颜色可在 Highlights 页配置；
• Show/Hide Line Numbers（仅 Editor）：编辑器左侧显示行号列。默认关闭（Lib/idlelib/config-main.def 中 [EditorWindow] line-numbers-default= 0），可在偏好中修改；
• Zoom/Restore Height：在普通尺寸与最大高度间切换窗口。初始尺寸默认 40 行 x 80 字符（即 Lib/idlelib/config-main.def [EditorWindow] width= 80, height= 40），除非在 General 页修改；窗口最大化时该切换无效。

Window 菜单（Shell 与 Editor 共有）

列出所有已打开窗口的名称，选中即将其置前（必要时解除最小化）。

Help 菜单（Shell 与 Editor 共有）

• About IDLE：显示版本、版权、许可证、致谢等；
• IDLE Help：显示本文档的 HTML 排版版本（与网页浏览效果接近的只读 tkinter 文本窗口，可用鼠标滚轮/滚动条/方向键导航，或点 TOC 按钮按章节跳转）；
• Python Docs：打开本地 Python 文档（若已安装）或启动浏览器访问 docs.python.org 对应运行版本的最新文档；
• Turtle Demo：运行 turtledemo 模块的海龟绘图示例；
• 附加帮助源：可在 Configure IDLE 对话框 General 页随时增删。

右键上下文菜单

右键（macOS 用 Control-点击）打开。所有窗口都有剪贴板操作（Cut/Copy/Paste）；编辑器窗口另有断点操作（Set Breakpoint / Clear Breakpoint）——设置断点的行有特殊标记，但断点仅在调试器下运行时才生效，且按文件保存在用户的 ~/.idlerc 目录；Shell 与输出窗口另有 Go to File/Line。

Shell 窗口右键菜单还有 Squeeze：当光标停在某条输出上时，把该条输出压缩为一个 "Squeezed text" 标签。输出行超过 N 行（默认 N=50，见下文）时自动压缩，右键单条输出可手动压缩。

四、编辑与导航机制

4.1 编辑器窗口

IDLE 启动时是否自动打开编辑器窗口，取决于设置与启动方式。同一文件只能有一个打开的编辑器窗口。标题栏含文件名、完整路径以及运行该窗口的 Python/IDLE 版本；状态栏显示行号 Ln 与列号 Col（行从 1 计数，列从 0 计数）。IDLE 假定已知 .py* 扩展名文件为 Python 代码，其余文件按普通文本处理；运行 Python 代码请走 Run 菜单。

4.2 键位绑定

文档中以 "C" 表示修饰键：Windows/Unix 上是 Control，macOS 上是 Command（以下均假设按键未被重绑定）。核心键位：

• 方向键逐字符/逐行移动光标；
• C-LeftArrow/C-RightArrow 按词移动；
• Home/End 到行首/行尾，Page Up/Page Down 翻屏；
• C-Home/C-End 到文件首/尾；
• Backspace/Del（或 C-d）删除前一/后一字符；
• C-Backspace/C-Del 删除左/右一个词；
• C-k 删除（"杀死"）光标右侧所有内容。

标准剪贴板键（C-c 复制、C-v 粘贴等）一般可用，具体按键方案在 Configure IDLE 对话框中切换。默认键位集定义于 Lib/idlelib/config-keys.def。

4.3 自动缩进

块开启语句之后，下一行自动缩进 4 空格（Python Shell 中缩进一个 Tab）；遇到 break、return 等关键字后自动减少缩进。在行首缩进处按 Backspace 一次最多删 4 个空格；Tab 按缩进宽度插入空格（Shell 中插入一个 Tab）。受 Tcl/Tk 限制，Tab 当前固定对应四个空格。相关默认值见 Lib/idlelib/config-main.def：[Indent] use-spaces= 1, num-spaces= 4，缩进分析逻辑在 Lib/idlelib/pyparse.py。

4.4 搜索与替换

窗口内任何选中内容都会成为搜索目标，但只有单行内的选择有效（搜索仅针对去掉行尾换行的整行进行）。勾选 [x] Regular expression 后，目标按 Python re 模块语法解释。搜索/替换/跨文件搜索共用底层引擎 Lib/idlelib/searchengine.py，对话框由 Lib/idlelib/searchbase.py 提供基础，跨文件实现见 Lib/idlelib/grep.py。

4.5 自动补全（Completions）

按需可对模块名、类/函数属性、文件名给出补全。补全框的交互方式：持续输入或删除字符会同步过滤并高亮候选项；可用 Up/Down/PageUp/PageDown/Home/End 或单击移动高亮；Escape、Enter、双击 Tab 或点击框外关闭；框内双击直接选中。

几种触发方式：

1. 等待自动弹出：输入关键字符后等待预定义延迟，默认 2 秒（源码 Lib/idlelib/config-extensions.def 的 [AutoComplete] popupwait= 2000），可在设置中修改；想完全禁用自动弹出，可把延迟设为极大毫秒数（如 100000000）。
   • 对已导入模块名或类/函数属性：输入 .；
   • 对根目录文件名：紧跟开头引号输入 os.sep 或 os.altsep（Windows 上可先输入盘符），再输入目录名与分隔符进入子目录。
2. 立即触发：Edit 菜单 Show Completions，默认热键 C-space。先输入前缀再打开补全框，会定位到首个匹配项；在引号后触发则补全当前目录文件名。
3. Tab 补全：前缀后按 Tab 通常等同于 Show Completions（无前缀时则执行缩进）；若前缀只有唯一匹配，则直接写入编辑器而不弹出补全框。

在字符串之外、无前导 . 时触发 Show Completions 或按 Tab，会出现包含关键字、内建名与可用模块级名字的补全框。编辑器内补全范围的提升技巧：编辑代码（而非 Shell）时，运行代码且不重启 Shell，可让模块级可用名字增多（顶部新增 import 后尤其有用），属性补全也随之更全。补全框默认排除以 _ 开头或不在 __all__ 中的名字；在 . 之后输入 _（框开前或开后均可）即可访问隐藏名。实现见 Lib/idlelib/autocomplete.py 与展示窗口 Lib/idlelib/autocomplete_w.py。

4.6 Calltip（调用提示）

输入可访问函数的名称后再输入 ( 会自动弹出 calltip。函数名表达式可含点号与下标。calltip 在以下情况消失：被点击、光标移出参数区、或输入了 )。光标位于某定义参数区时，可随时通过 Edit > Show Call Tip 或其快捷键再次显示。

calltip 内容 = 函数签名 + docstring（截取到首个空行或第 5 个非空行；部分内建函数没有可访问签名）。签名中的 / 与 * 表示此前/此后的参数只可位置传递或只可关键字传递。实现见 Lib/idlelib/calltip.py（文本生成）与 Lib/idlelib/calltip_w.py（弹窗显示）。

Shell 中"可访问函数"取决于自上次重启以来用户进程导入了哪些模块（含 IDLE 自身导入的）以及运行过哪些定义。示例：

• 重启 Shell 后输入 itertools.count( 会出现 calltip——因为 IDLE 自己把 itertools 导入了用户进程（此行为未来可能变化）；
• 输入 turtle.write( 则无提示——IDLE 并未导入 turtle；
• 先执行 import turtle，此后 turtle.write( 就能显示 calltip。

编辑器里同理：import 语句只有运行文件后才生效。因此建议在写完 import 语句、添加完函数定义或打开既有文件后运行一次文件。

4.7 段落重排（Format block）

Reformat Paragraph 会把一段"由连续、等缩进的非空注释"或"多行字符串中的类似文本块"（或二者的选中子集）重新折行。必要时插入空行把字符串与代码隔开；选中的部分行会被扩展为完整行。重排后各行保持原缩进，但总长度不超过 N 列，N 默认 72，可在设置对话框 Window 页修改。

4.8 代码上下文（Code Context）

对含 Python 代码的编辑器窗口，可在顶部开关一块冻结了 class/def/if 等块开头行的面板，这些行本会随滚动移出视野。面板高度随当前上下文层级自动伸缩，上限默认 15 行；无上下文且已开启时显示一条空行。单击上下文行会把它滚回编辑器顶部。面板文字与背景色可在 Highlights 页配置。

4.9 Shell 窗口的交互特性

Shell 支持输入、编辑、回忆完整语句（普通终端通常一次只能处理一行物理文本）：

• 单行语句：光标在该行任意位置按 Return 即提交执行；
• 反斜杠续行（\）时，光标必须位于最后一个物理行；
• 多行复合语句：输入完语句后再输入一个空行提交；
• 粘贴进 Shell 的代码在按 Return 前不会编译执行，可先编辑；若一次粘贴多条语句会因被当做一个整体编译而报 SyntaxError；
• 行中出现 RESTART 字样表示用户执行进程已重启（进程崩溃、手动 Restart Shell、或从编辑器运行代码时都会发生）。

Shell 特有的按键：

• C-c：尝试中断语句执行（可能失败）；
• C-d：在 >>> 提示符处输入则关闭 Shell；
• Alt-p/Alt-n（macOS 用 C-p/C-n）：把前一条/后一条与当前已输入内容匹配的历史语句取回到提示符处；
• Return 停在历史某条语句上时，把该语句追加到当前已输入内容后。

Shell 的历史管理实现在 Lib/idlelib/history.py。

4.10 文本颜色与高亮主题

IDLE 默认为黑底白字（即白底黑字正文），但会为有特殊含义的文本着色：

• Shell 中区分：shell 输出、shell 错误、用户输出、用户错误四类；
• Python 代码（Shell 提示符处或编辑器中）区分：关键字、内建类与函数名、class/def 后的名字、字符串、注释；
• 任何文本窗口区分：光标、被找到的文本、选中文本。

IDLE 还会高亮 match/case/_ 这些模式匹配软关键字；但高亮并不完美，个别 case 模式中的 _ 等罕见情形会出错。着色在后台进行，偶尔能看到未上色的瞬时文本。配色主题可在 Configure IDLE 对话框的 Highlighting 页更换；断点行标记、弹出框与对话框内的文本不可由用户自定义。默认高亮主题定义见 Lib/idlelib/config-highlight.def，实现为 Lib/idlelib/colorizer.py。

五、启动、执行与 RPC 架构

5.1 启动文件（IDLESTARTUP / PYTHONSTARTUP / .Idle.py）

以 -s 选项启动时，IDLE 会执行 IDLESTARTUP 或 PYTHONSTARTUP 环境变量引用的文件：先检查 IDLESTARTUP，存在则执行；否则检查 PYTHONSTARTUP。这类文件适合存放经常要在 IDLE Shell 里用的函数、或自动导入公共模块的 import 语句。

另外，Tk 还会无条件加载用户主目录下的 .Idle.py 启动文件，但其语句在 Tk 命名空间中执行，因此不能用于为 IDLE 的 Python Shell 准备可导入函数。

5.2 双进程执行模型与 RPC

除个别例外，IDLE 中运行 Python 代码的结果应与"直接在文本模式系统终端中运行同一段代码"一致，但界面与运行机制的差异偶尔影响可见结果，例如：sys.modules 初始条目更多、threading.active_count() 返回 2 而非 1。

IDLE 默认把用户代码运行在独立 OS 进程（而非承载 Shell/编辑器的 UI 进程）中：UI 进程与用户执行进程之间通过套接字 + RPC 通信（实现见 Lib/idlelib/rpc.py，本地回环地址 LOCALHOST = '127.0.0.1'，默认调试端口为 6543），执行进程的启动模板见 Lib/idlelib/run.py。执行进程中：

• sys.stdin、sys.stdout、sys.stderr 被替换为与 Shell 窗口交换数据的对象；sys.__stdin__/__stdout__/__stderr__ 保持原值不动（可能为 None）；
• 若用户代码重置了 sys（如 importlib.reload(sys)），IDLE 的替换会丢失，键盘输入与屏幕输出将不正常；
• 跨进程把 print 输出送到文本控件比同一进程写终端慢，逐参数发送每个字符串、分隔符与换行尤其明显——想加快输出，应把要一起显示的内容用格式串或 str.join 拼成单个字符串再打印；
• IDLE 对标准流的替换不会被执行进程派生的子进程继承。子进程（含 multiprocessing 模块产生的）若读写标准流，应在命令行窗口启动 IDLE（Windows 上请用 python/py，不要用 pythonw/pyw），子进程将挂接到该终端进行输入输出；
• 当 Shell 拥有焦点时它独占键盘与屏幕，直接访问键盘/屏幕的系统级函数无法工作；
• IDLE 在执行进程中会额外加入调用栈帧，为此包装了 sys.getrecursionlimit/sys.setrecursionlimit 以抵消额外栈帧的影响；
• 用户代码抛出 SystemExit（或调用 sys.exit）时，IDLE 回到 Shell 提示符而不是退出。

5.3 Shell 中的用户输出语义

• Shell 从不丢弃输出：无限输出最终会耗尽内存并报内存错误（对比：Windows 控制台默认只保留 300 行，可设 1–9999）；
• 底层 Tk Text 控件只显示 Unicode BMP（基本多语言平面）内字符；某字符显示为字形还是替换框取决于操作系统与字体。Tab 推进到下一个制表位（每 8 个"字符"一处），换行另起一行，其他控制字符按操作系统与字体被忽略或显示为空格/方框等。文档给出的演示：

>>> s = 'a\tb\a<\x02><\r>\bc\nd'  # 输入 22 个字符
>>> len(s)
14
>>> s                # 显示 repr(s)
'a\tb\x07<\x02><\r>\x08c\nd'
>>> print(s, end='') # 原样显示 s
# 结果因 OS 与字体而异，可以亲自试试。

• 交互式回显表达式值时使用 repr，它把控制码、部分 BMP 码点与所有非 BMP 码点替换为转义序列——无论显示成什么样，都能据此辨识字符串中的真实字符；
• 普通输出与错误输出彼此、与代码输入之间通常分列不同行，使用不同高亮色；
• SyntaxError traceback 不再用 ^ 标注错误位置，而是以错误高亮着色整段文字；从文件运行的代码引发其他异常时，右键点击 traceback 行可跳转到编辑器对应行（必要时自动打开文件）；
• 输出压缩（Squeeze）：Shell 自动把超过 N 行的输出压成 "Squeezed text" 标签，N 默认 50，可在 Settings 对话框 General 页的 PyShell 区修改（对应 Lib/idlelib/config-main.def 中 [PyShell] auto-squeeze-min-lines= 50）；更短的输出可右键手动压缩，对超长行（拖慢滚动）很实用。双击标签原位展开；右键标签可把内容复制到剪贴板或送入独立视图窗口。实现见 Lib/idlelib/squeezer.py。

5.4 用 IDLE 开发 tkinter 应用

IDLE 为方便 tkinter 程序开发而有意区别于标准 Python：在标准 Python 中执行 import tkinter as tk; root = tk.Tk() 不会出现任何窗口，而 IDLE 中会立刻弹出 tk 窗口——IDLE 在后台约每 50ms（每秒约 20 次）代做 root.update()。标准 Python 中执行 b = tk.Button(root, text='button'); b.pack() 后同样要 root.update() 才能看到变化。

多数 tkinter 程序以 root.mainloop() 收尾，它会一直运行到 tk 应用销毁才返回——因此用 python -i 或从 IDLE 编辑器运行时，>>> 提示符要等 mainloop() 返回才出现，届时已无对象可交互。从 IDLE 编辑器运行时，可临时注释掉 mainloop 调用：立刻得到 Shell 提示符并与"活"应用交互；在标准 Python 里跑之前记得恢复 mainloop。

5.5 无子进程运行（-n，已弃用）

默认的 socket 子进程走内部回环接口，外部不可见、不联网收发数据；防火墙若报警可忽略。若建连失败且持续存在，多半是防火墙拦截或系统网络配置问题，此时可用 -n 开关：

-n 模式下 IDLE 单进程运行、不创建承载 RPC Python 执行服务器的子进程，适合"Python 无法创建子进程或本平台 RPC socket 不可用"的场景。代价是：用户代码与 IDLE 本身不再隔离；Run/Run Module（F5）不再重启环境，改代码后必须自行 reload() 受影响模块、重新 import 具体对象（如 from foo import baz）才能生效。因此只要可能就应使用默认子进程模式。该选项自 Python 3.4 起标记弃用（源码 Lib/idlelib/pyshell.py 的 -n 分支会打印弃用警告）。

5.6 启动失败的排查

IDLE 的 GUI 进程与用户代码执行进程间用套接字通信，Shell 每次启动/重启都要建连（重启在界面上表现为带 RESTART 字样的分隔线）。建连失败通常弹出一个提示 "cannot connect" 的 Tk 错误框并退出。常见原因与对策：

• Unix 系统网络伪装（masquerading）规则配置错误：从终端启动时看到 ** Invalid host: 开头的消息即属此类，合法值是 127.0.0.1 (idlelib.rpc.LOCALHOST)。可在两个终端分别用 tcpconnect -irv 127.0.0.1 6543 与 tcplisten <同样参数> 诊断；
• 用户自建文件与标准库同名（如 random.py、tkinter.py）且位于待运行文件同目录，会遮蔽标准库导入——解决办法是改名；
• 杀毒/防火墙拦截：若无法放行该连接只能暂时关闭；内部连接不暴露到外部端口，放行是安全的。网络配置阻断连接也是同类问题；
• Python 安装问题：多版本冲突或单版本缺管理员权限；冲突无法解决或不愿用管理员权限时，最稳妥是彻底卸载重装；
• Windows 上的僵尸 pythonw.exe 进程：用任务管理器查找并结束；程序崩溃或 Ctrl-C 中断引发的重启偶有连接失败，关掉错误框或使用 Shell 菜单 Restart Shell 通常可恢复；
• 配置损坏：首次启动会读取 ~/.idlerc/ 用户配置，出错会给出消息。官方强烈建议不要手工编辑这些文件，一律通过 Options 下的配置对话框修改；一旦出错，删除坏文件后用设置对话框重来往往是最佳方案；
• 静默退出：未从控制台启动时可能无消息；改从控制台/终端执行 python -m idlelib 观察报错；
• Tcl/Tk 版本过旧（< 8.6.11，见 About IDLE）：Unix 系系统上某些字体的某些字符会触发 tk 失败并打印到终端；无法升级 tcl/tk 时，可把 IDLE 改用兼容性更好的字体。

六、帮助与偏好设置

6.1 帮助源

• Help > IDLE Help 显示本文档（Library Reference 中 IDLE 章节）的格式化 HTML 版本，呈现在只读 tkinter 文本窗口中；可用鼠标滚轮、滚动条、长按上下方向键导航，或用 TOC 按钮弹出章节列表跳转；
• Help > Python Docs 打开 docs.python.org/x.y（x.y 为运行版本）的教程等资料；系统装有离线文档副本（可能是安装选项）时则打开本地副本；
• 任意时刻可用 Configure IDLE 对话框的 General 页增删 Help 菜单上的 URL。

6.2 偏好配置模型与文件布局

字体、高亮、按键、通用项均可在 Options > Configure IDLE 中修改；非默认设置保存到用户主目录下的 .idlerc/ 目录，配置损坏时通过编辑或删除 .idlerc 中的相应文件解决。配置文件分两层：

• 默认配置位于 idlelib 包内（Lib/idlelib/config-main.def、Lib/idlelib/config-extensions.def、Lib/idlelib/config-highlight.def、Lib/idlelib/config-keys.def）；
• 用户配置位于 ~/.idlerc/ 下的 config-main.cfg、config-extensions.cfg、config-highlight.cfg、config-keys.cfg（Windows 上 ~ 依版本而定，如 Windows 10 为 C:\Users\<用户名>）。用户文件会覆盖默认值；把某项恢复为默认即从用户文件清除该条目，规则对各项分别生效（编辑器三个字体项作为一组保存）。

各页要点：

• Font 页：文本样例展示字体族与字号对多种语言字符的效果；可编辑样例加入关心的字符以实测；优先选等宽字体。若某字符在 Shell 或编辑器中显示异常，把其加到样例顶部，先调字号再换字体；
• Highlights 与 Keys 页：选择内建或自定义配色主题与按键集。若想让新主题/按键集在旧版 IDLE 中可用，可另存为新的自定义主题/按键集，旧版即可访问（~/.idlerc 中保存的主题名/键集名须与默认名不同）。

附加帮助源配置格式（Lib/idlelib/config-main.def 头部说明）：在 [HelpFiles] 段写 <序列号 = 菜单项;路径/URL>，菜单项与路径中不能出现分号，路径因平台路径分隔符而各异。示例：

[HelpFiles]
1 = IDLE;C:/Programs/Python36/Lib/idlelib/help.html
2 = Pillow;https://pillow.readthedocs.io/en/latest/

6.3 macOS 注意事项

macOS 系统偏好 > Dock 中若把 "Prefer tabs when opening documents" 设为 "Always"，会与 IDLE 依赖的 tk/tkinter GUI 框架不兼容，破坏若干 IDLE 功能。

6.4 扩展机制（Extensions）

IDLE 内置扩展机制，扩展偏好可在配置对话框 Extensions 页调整；更多说明见 Lib/idlelib/config-extensions.def 开头的注释以及面向扩展作者的 Lib/idlelib/extend.txt。扩展配置规则：

• 每个扩展至少有一个以扩展模块命名的节，含 enable（True/False）；可用 enable_editor/enable_shell 限定仅编辑器或仅 Shell 启用；
• 键位分两类节：ExtensionName_bindings（虚拟事件绑定，用户不可改）与 ExtensionName_cfgBindings（可合理重配的绑定）；改动绑定需手工修改默认文件或建立 ~/.idlerc/config-extensions.cfg 覆盖；若某绑定已占用，扩展装载时该虚拟事件键位被置空；
• 默认随包编译进核心功能的 [AutoComplete] popupwait= 2000、[CodeContext] maxlines= 15、[FormatParagraph] max-width= 72、[ParenMatch] style= expression 等节是为了向后兼容保留在此；
• 当前唯一的默认"扩展"是 ZzDummy——用于测试的示例扩展（默认 enable= False），启用后在菜单中插入 Zin/Zout 项，执行时在每行首插入/删除 z 文本。编写扩展的完整指引见 Lib/idlelib/extend.txt。

七、实现包小结：Lib/idlelib 结构速查

Lib/idlelib/README.txt 把 idlelib 的文件分为四类，作为理解与二次开发的地图：

类别	代表文件	职责
启动	main.py、idle.py、idle.pyw	python -m idlelib 即经 __main__.py 调用 pyshell.main()
实现	pyshell.py、editor.py、run.py、rpc.py、runscript.py、configdialog.py 等	Shell/编辑器、子进程运行、RPC、菜单逻辑
配置默认值	config-main.def 等四个 .def	通用/扩展/高亮/按键默认配置
文档文本	help.html（本文档 HTML 版）、README.txt、extend.txt	IDLE 内 Help 与开发者指引

同时 Lib/idlelib/idle_test/ 存放与各模块配套的自动化单元测试，可作为理解各功能细节的补充示例。

八、小结

作为随 CPython 分发的轻量 IDE，IDLE 覆盖了从交互式 Shell、多文件编辑、自动补全与 calltip 到断点调试、跨文件 grep、配置与扩展的完整开发闭环，其"UI 进程 + 子进程 RPC"的执行模型与 tkinter 后台 update 机制尤其适合 Python 入门教学与 tkinter 原型验证。若想进一步了解菜单与代码的精确对应关系、自定义扩展乃至参与维护，仓库内的 Doc/library/idle.rst、Lib/idlelib/README.txt 与 Lib/idlelib/config-extensions.def 是最直接的入口。