设置
IDE 配置项说明，与设置页面的分组一一对应。
菜单 → 设置，或使用快捷键打开设置页面。设置分为工作区、界面和关于三大区。插件可通过 SDK 的 self.settings 读写这些配置项，名称对应关系见 settings SDK 参考。
工作区
编辑器
字体
| 设置项 | 说明 | 设置键 |
|---|---|---|
| 字体 | 代码编辑器字体（JetBrains Mono、JetBrains Maple Mono、自定义） | editor.font_family |
| 字号 | 编辑器字号 | editor.font_size |
编辑器主题
选择语法高亮配色方案。浅色和深色变体跟随应用主题。
上传确认
上传文件时的确认方式：
- 浮动工具栏（默认） —
editor.upload_confirm_style = "toolbar" - 确认对话框 —
editor.upload_confirm_style = "dialog"
编辑行为
| 设置项 | 说明 | 设置键 |
|---|---|---|
| 自动换行 | 长行自动换行 | editor.word_wrap |
| 显示行号 | 显示左侧行号 | editor.line_number |
| 显示分隔线 | 行号与代码间显示分隔线 | editor.gutter_divider |
| 代码折叠 | 显示折叠图标 | editor.code_folding |
| 缩进参考线 | 显示缩进参考线 | editor.guide_lines |
| 本地补全 | 启用非 LSP 本地补全 | editor.local_suggestions |
| 键盘建议 | 允许系统键盘显示输入建议 | editor.keyboard_suggestions |
| Tab 插入空格 | 按 Tab 插入空格 | editor.use_space_as_tab |
| Tab 大小 | Tab 对应的空格数 | editor.tab_size |
| 中文转 Unicode | 自动转换中文输入 | editor.chinese_to_unicode |
| 信号断开检测 | 通过信号线检测串口断开 | editor.enable_signal_detection |
快捷键
| 设置项 | 说明 | 设置键 |
|---|---|---|
| 确认快捷键 | 默认 Ctrl+Enter | editor.confirm_shortcut |
| 取消快捷键 | 默认 Esc | editor.cancel_shortcut |
调试和终端
串口设置
| 设置项 | 说明 | 设置键 |
|---|---|---|
| 波特率 | 默认串口波特率，默认 115200 | serial.default_baud_rate |
| 自动重连 | 断开后自动重连 | serial.auto_reconnect |
| REPL 模式 | 文件同步与 REPL 交互使用的模式：Raw REPL 或 Paste | serial.repl_mode |
| 文件传输模式 | 设备文件同步方式：streaming 或 chunked | serial.file_transfer_mode |
| 硬件复位策略 | 连接时复位策略：disabled、DTR 脉冲、RTS 脉冲或 ESP32 | serial.hardware_reset_strategy |
| 检查板文件系统 | 连接时检查板文件系统 | — |
| 中文转 Unicode | 自动转换中文输入 | editor.chinese_to_unicode |
终端显示
| 设置项 | 说明 | 设置键 |
|---|---|---|
| 字体 | 终端字体 | terminal.font_family |
| 字号 | 终端字号 | terminal.font_size |
| 行高 | 终端行高 | terminal.line_height |
| 下划线 | 桌面终端下划线显示 | terminal.desktop_underline |
WebREPL
通过 WiFi 连接设备：
| 设置项 | 说明 | 设置键 |
|---|---|---|
| 启用 WebREPL | 开启 WiFi 连接 | — |
| 设备 IP 地址 | 设备的 IP 地址 | webrepl.host |
| 端口 | WebREPL 端口，默认 8266 | webrepl.port |
| 密码 | WebREPL 访问密码 | webrepl.password |
语言服务器
| 设置项 | 说明 | 设置键 |
|---|---|---|
| 启用语言服务器 | 开启 LSP 支持 | lsp.enabled |
| 连接类型 | stdio 或 WebSocket | lsp.type |
| WebSocket 地址 | 远程服务器地址，默认 127.0.0.1:2026 | lsp.websocket_path |
| 可执行文件路径 | 本地 LSP 进程路径 | lsp.stdio_executable |
| 启动参数 | LSP 启动参数 | lsp.stdio_args |
| 禁用警告诊断 | 关闭警告下划线诊断 | lsp.disable_warning |
| 禁用错误诊断 | 关闭错误下划线诊断 | lsp.disable_error |
| 语义高亮 | 使用 LSP 语义令牌高亮 | lsp.semantic_highlighting |
| 代码补全 | LSP 补全建议 | lsp.code_completion |
| 悬停信息 | 悬停显示文档 | lsp.hover_info |
| 代码操作 | 快速修复与重构 | lsp.code_action |
| 签名帮助 | 函数签名提示 | lsp.signature_help |
| 文档颜色 | 渲染颜色标记 | lsp.document_color |
| 文档高亮 | 高亮同一符号引用 | lsp.document_highlight |
| 代码折叠 | LSP 折叠范围 | lsp.code_folding |
| 内联提示 | 内联参数/类型提示 | lsp.inlay_hint |
| 跳转定义 | 转到定义 | lsp.go_to_definition |
| 重命名 | 符号重命名 | lsp.rename |
Stubs 配置
| 设置项 | 说明 | 设置键 |
|---|---|---|
| 启用 Stubs | 允许语言服务使用类型存根 | micropython.stubs.enabled |
| 自动检测层级 | 根据连接设备推荐存根层级 | micropython.stubs.auto_detect_layers |
| 存根层级 | 启用的存根 provider/profile 列表 | micropython.stubs.layers |
| 额外路径 | 额外的存根文件路径 | micropython.stubs.extra_paths |
界面
外观和样式
| 设置项 | 说明 | 设置键 |
|---|---|---|
| 主题模式 | 自动 / 日光 / 黑夜 | theme.mode |
| 主题风格 | 标准 / 紧凑 / 舒适 | theme.style |
| 主题颜色 | 跟随系统、插件主题或自定义 ARGB 颜色 | theme.color / theme.active_plugin_theme_id |
| 菜单样式 | Material 3 右键菜单 | theme.use_material_context_menu |
功能面板
| 设置项 | 说明 |
|---|---|
| 功能面板 | 显示/隐藏函数导航面板 |
| 控制台面板 | 显示/隐藏控制台输出面板 |
| 扩展面板 | 显示/隐藏扩展信息面板 |
语言
切换 IDE 显示语言。语言包由插件贡献。语言切换使用 默认 跟随系统。
关于
显示应用信息、运行时路径、插件统计、诊断摘要等。
设置项名称区分大小写。修改 theme.mode、editor.font_size 等键会立即生效并持久化；插件覆盖用户配置前请谨慎。完整名称列表可调用 SDK 的 self.settings.list() 获取。