code --- 直譯器基底類別¶
原始碼：Lib/code.py
code 模組提供在 Python 中實作讀取-求值-印出迴圈（read-eval-print loops）的設施。包含兩個類別和便利函式，可用於建立提供互動式直譯器提示的應用程式。
-
class code.InteractiveInterpreter(locals=None)¶
這個類別處理剖析和直譯器狀態（使用者的命名空間）；它不處理輸入緩衝、提示或輸入檔案命名（檔案名稱總是明確傳入）。可選的 locals 引數指定一個對映，作為執行程式碼的命名空間；它預設為新建立的字典，鍵 '__name__' 設為 '__console__' 而鍵 '__doc__' 會設為 None。
請注意，在 InteractiveInterpreter 實例下建立的函式和類別物件將屬於由 locals 指定的命名空間。只有當 locals 是現有模組的命名空間時，它們才會是可被 pickle 的。
-
class code.InteractiveConsole(locals=None, filename='<console>', *, local_exit=False)¶
近似地模擬出互動式 Python 直譯器的行為。這個類別建立在 InteractiveInterpreter 的基礎上，並加入使用熟悉的 sys.ps1 和 sys.ps2 的提示，以及輸入緩衝。如果 local_exit 為 true，控制台中的 exit() 和 quit() 將不會引發 SystemExit，而是回傳到呼叫程式碼。
在 3.13 版的變更: 新增 local_exit 參數。
-
code.interact(banner=None, readfunc=None, local=None, exitmsg=None, local_exit=False)¶
執行 read-eval-print 迴圈的便利函式。這會建立一個 InteractiveConsole 的新實例，並設定 readfunc 以用於 InteractiveConsole.raw_input() 方法（如有提供）。如果 local 有被提供，它會被傳給 InteractiveConsole 的建構函式以作為直譯器迴圈的預設命名空間。如果有提供 local_exit，它會被傳給 InteractiveConsole 構建函式。然後實例的 interact() 方法會執行，並傳入 banner 和 exitmsg 以作為要使用的橫幅和退出訊息（如有提供）。控制台物件在使用後就會被丟棄。
在 3.6 版的變更: 新增 exitmsg 參數。
在 3.13 版的變更: 新增 local_exit 參數。
-
code.compile_command(source, filename='<input>', symbol='single')¶
這個函式對於想要模擬 Python 的直譯器主迴圈（即讀取-求值-印出迴圈）的程式很有用。最棘手的部分是判斷使用者何時輸入了一個不完整的命令，而這個命令可以透過輸入更多文字來完成（相對於完整的命令或語法錯誤）。這個函式幾乎總是做出與真正的直譯器主迴圈相同的判斷。
source 是來源字串；filename 是讀取來源的可選檔案名稱，預設為 '<input>'；symbol 是可選的文法 (grammar) 起始符號，其應為 'single'（預設值）、'eval' 或 'exec'。
如果命令完整且有效，則回傳程式碼物件（與 compile(source,filename,symbol) 相同）；如果命令不完整，則回傳 None；如果命令完整但包含語法錯誤，則引發 SyntaxError，如果命令包含無效的字面值 (literal)，則引發 OverflowError 或 ValueError。
互動式直譯器物件¶
-
InteractiveInterpreter.runsource(source, filename='<input>', symbol='single')¶
在直譯器中編譯並執行某些原始碼。引數與 compile_command() 相同；filename 的預設值是 '<input>'，symbol 的預設值是 'single'。有幾種情況會發生：
回傳值可用來決定是使用 sys.ps1 還是 sys.ps2 以提示下一列。
-
InteractiveInterpreter.runcode(code)¶
執行程式碼物件。當例外發生時，會呼叫 showtraceback() 來顯示回溯。除了 SystemExit 允許繼續傳播之外，所有的例外都會被捕獲。
關於 KeyboardInterrupt 的注意事項：此例外可能發生在此程式碼的其他地方，而且不一定會被捕獲到。呼叫者應該準備好處理它。
-
InteractiveInterpreter.showsyntaxerror(filename=None)¶
顯示剛剛發生的語法錯誤。這不會顯示堆疊追蹤 (stack trace)，因為語法錯誤沒有堆疊追蹤。如果給出 filename，它會被塞入例外，而不是 Python 剖析器提供的預設檔案名稱，因為它從字串讀取時總是使用 '<string>'。輸出會由 write() 方法寫入。
-
InteractiveInterpreter.showtraceback()¶
顯示剛剛發生的例外。我們移除第一個堆疊項目，因為它在直譯器物件的實作範圍內。輸出由 write() 方法寫入。
在 3.5 版的變更: 會顯示完整的連鎖回溯記錄，而不只是主要回溯。
-
InteractiveInterpreter.write(data)¶
寫入字串到標準錯誤串流 (sys.stderr)。衍生類別應覆寫此功能，以根據需求提供適當的輸出處理。
互動式控制台物件¶
InteractiveConsole 類別是 InteractiveInterpreter 的子類別，因此提供了所有直譯器物件的方法以及下列新增的功能。
-
InteractiveConsole.interact(banner=None, exitmsg=None)¶
近似地模擬互動式 Python 控制台。可選的 banner 引數指定在第一次互動之前要印出的横幅；預設會印出類似標準 Python 直譯器所列印的横幅，接著是控制台物件在括弧中的類別名稱 (以免與真正的直譯器混淆 -- 因為它是如此接近！)。
可選的 exitmsg 引數指定退出時列印的退出訊息。傳遞空字串以抑制退出訊息。如果沒有給 exitmsg 或 None，則會印出預設訊息。
在 3.4 版的變更: 若要抑制印出任何橫幅，請傳入空字串。
-
InteractiveConsole.push(line)¶
推送一行原始文字到直譯器。這一行不應該有尾部換行符號；它可能有內部換行符號。這行文字會被附加到緩衝區，並且直譯器的 runsource() 方法會被呼叫，並以緩衝區的串接內容做為原始碼。如果這表示命令已執行或無效，緩衝區會被重設；否則，命令會不完整，且緩衝區會保持該行被附加後的樣子。如果需要更多的輸入，回傳值是 True，如果該行已經以某種方式處理，回傳值是 False（這與 runsource() 相同）。
-
InteractiveConsole.resetbuffer()¶
從輸入緩衝區移除任何未處理的原始文字。
-
InteractiveConsole.raw_input(prompt='')¶
寫入一個提示並讀取一行。回傳的行不包括尾部的換行符號。當使用者輸入 EOF 鍵序時，會引發 EOFError。基底實作會從 sys.stdin 讀取；子類別可以用不同的實作替代。
©
版權所有 2001 Python Software Foundation.
此頁面採用 Python 軟體基金會授權條款第 2 版。
文件中的範例、應用技巧與其他程式碼額外採用了 Zero Clause BSD 授權條款。
更多訊息請見
歷史與授權條款。
Python 軟體基金會是一家非營利法人。
敬請捐贈。
最後更新於 11月 11, 2026 (06:44 UTC)。
發現 bug？
以
Sphinx8.2.3建立。