REPL

相关源文件

• cli/cdp.rs
• cli/tools/repl/channel.rs
• cli/tools/repl/editor.rs
• cli/tools/repl/mod.rs
• cli/tools/repl/session.rs
• cli/tools/run/hmr.rs
• tests/integration/watcher_tests.rs

REPL（Read-Eval-Print Loop）系统为 Deno 提供了一个交互式的 JavaScript 和 TypeScript 执行环境。它使用户能够实时执行代码片段、探索 API 和测试功能，并支持完整的 TypeScript、智能代码补全和语法高亮。

有关提供智能功能的语言服务器协议实现的更多信息，请参阅 语言服务器协议。有关底层 CLI 命令处理的详细信息，请参阅 CLI 架构。有关运行时执行的详细信息，请参阅 运行时架构。

架构概述

REPL 系统围绕三个主要组件构建，这些组件协同工作以提供交互式开发体验。

来源：cli/tools/repl/mod.rs41-45 cli/tools/repl/session.rs173-189 cli/tools/repl/editor.rs420-425 cli/tools/repl/channel.rs111-114

核心会话管理

ReplSession 结构体作为 REPL 功能的中心协调器，管理 V8 执行上下文、TypeScript 转译和求值管道。

组件	目的	关键方法
ReplSession	主要会话控制器	evaluate_line_and_get_output, evaluate_ts_expression
MainWorker	JavaScript 运行时环境	执行上下文和模块加载
LocalInspectorSession	Chrome DevTools Protocol 接口	post_message_with_event_loop, evaluate_expression
ReplLanguageServer	用于补全的 LSP 集成	completions, commit_text

会话初始化过程建立执行环境，并注入一个设置了 REPL 特定全局变量的序言脚本。

来源：cli/tools/repl/session.rs192-292 cli/tools/repl/session.rs86-134

求值管道

REPL 求值过程处理 TypeScript 转译、表达式的对象包装以及错误格式化。

求值过程包含几个关键转换：

• 对象包装：以 { 开头的表达式被包装在括号中，以将其视为对象字面量而非块语句。cli/tools/repl/session.rs437-443
• TypeScript 转译：代码使用具有 JSX 和装饰器支持的 AST 系统进行解析和转译。cli/tools/repl/session.rs664-695
• NPM 导入检测：系统会自动检测并安装导入语句中引用的 NPM 包。cli/tools/repl/session.rs729-776

来源：cli/tools/repl/session.rs430-485 cli/tools/repl/session.rs639-705 cli/tools/repl/session.rs729-776

编辑器集成

ReplEditor 通过集成 Rustyline 库和 Deno 的语言服务，提供了高级编辑功能。

代码补全

补全系统通过分析当前输入上下文并查询 V8 运行时和语言服务器，提供智能建议。

• 属性补全：对于 obj.prop 等表达式，它会求值对象的类型并检索可用的属性。cli/tools/repl/editor.rs204-214
• 全局作用域：结合 globalThis 属性和词法作用域声明。cli/tools/repl/editor.rs216-229
• LSP 集成：回退到语言服务器补全以获取高级 TypeScript 功能。cli/tools/repl/editor.rs193-200

输入验证

验证系统使用令牌级分析来确定何时输入已完成或需要继续。

• 括号匹配：跟踪开括号、闭括号、花括号和圆括号。cli/tools/repl/editor.rs277-298
• 模板字面量：处理未终止的模板字符串以实现多行输入。cli/tools/repl/editor.rs276-302
• 正则表达式检测：使用启发式方法避免与除法运算符的误判。cli/tools/repl/editor.rs267-275

来源：cli/tools/repl/editor.rs184-231 cli/tools/repl/editor.rs233-321 cli/tools/repl/editor.rs323-417

通信桥梁

REPL 通过消息传递系统桥接同步编辑器操作和异步 Deno 操作。

通道系统处理两种类型的操作：

• CDP 消息：用于运行时评估和属性检查的直接 Chrome DevTools Protocol 调用 cli/tools/repl/channel.rs40-44
• LSP Completions：用于智能代码补全的语言服务器请求 cli/tools/repl/channel.rs45-48

来源：cli/tools/repl/channel.rs23-38 cli/tools/repl/channel.rs61-109 cli/tools/repl/channel.rs116-127

集成点

REPL 集成了多个 Deno 子系统，以提供完整的开发环境

运行时集成

• Worker 创建：使用 CliMainWorkerFactory 创建独立的执行环境 cli/tools/repl/mod.rs187-198
• 权限系统：继承 CLI 选项的权限配置 cli/tools/repl/mod.rs175
• 模块解析：利用标准的 Deno 模块解析器 cli/tools/repl/session.rs176

测试集成

• 测试检测：检测到 Deno.test() 调用时自动运行测试 cli/tools/repl/session.rs463-482
• 测试报告：使用与主测试运行器相同的报告基础架构 cli/tools/repl/session.rs267-276

开发工具

• JSX 支持：分析 JSX pragma 并相应地配置转译 cli/tools/repl/session.rs707-727
• Source Maps：维护源映射以改善错误报告 cli/tools/repl/session.rs686-692
• 历史管理：跨会话持久化命令历史记录 cli/tools/repl/editor.rs458-466

来源：cli/tools/repl/mod.rs168-278 cli/tools/repl/session.rs463-482 cli/tools/repl/session.rs707-727