页面Python 编辑器 · 5 / 29
Python 编辑器
Python 编辑器是 QuantCraft IDE 的核心（工作区布局）。每当您在 Files Sidebar 中选择文件，或在编辑器标签栏中打开标签页时，它就会打开，并提供专为编写 Python 交易策略而优化的完整、现代的编码体验。在 Packages 下管理库（依赖项）；使用 Run / Test 运行代码（运行代码）。
本页涵盖您最常用的四个方面：
编辑
打开文件后，编辑器会占据 IDE Main Panel 的中央区域，其行为与您已经熟悉的 Python 编辑器一样。
编写代码
- Python 语法高亮，颜色由您选择的编辑器主题决定。
- 智能缩进 — 在行尾按 Enter，下一行会按 Python 规范正确缩进（在
def、class、if、for、with等之后）。 - 自动换行 — 长行在视觉上自动换行，无需水平滚动。实际内容不会改变。
- 编辑器内关闭拼写检查，因此标识符和关键字不会被加下划线。
- Tab 键插入 4 个空格。
自动补全
输入时，编辑器会提供上下文感知的建议：
- 常见 Python 模式的代码片段：
def、class、for、while、try、with、lambda、import、from、ifmain等。 - 标准库和已安装的软件包 — 输入
import或from会建议来自 IDE Python 环境的模块，以及您自己的工作区文件夹和文件。 - 成员补全 — 在模块、软件包或已知的 QuantCraft 对象（例如
bar.、fundamentals.、pd.）之后输入.，会列出可用的属性和方法。在策略回调中请优先使用bar.和fundamentals.—— 在 IDE 中，模块级的qc_ohlcv在导入时往往尚未设置。 - 建议会自动出现；您也可以使用 Ctrl+Space 显式触发。
在工作区文件之间导航
- 在
import或工作区符号上按 Ctrl+点击（macOS 上为 Cmd+点击），会在编辑器中跳转到该文件，并将光标置于对应行。 - 每个标签页都会在两次访问之间记住自己的滚动位置和光标位置，因此切换文件总能让您回到上次离开的确切位置。
查找与替换
编辑器顶部内置了搜索面板：
- Find —
Ctrl+F（或使用 Edit → Find）。 - Replace —
Ctrl+H（或使用 Edit → Replace）。 - 只有在文件可编辑时才会显示替换行。
标准编辑命令
所有标准编辑操作都可通过编辑器工具栏中的 Edit 菜单和键盘快捷键使用：
| 操作 | 快捷键 |
|---|---|
| 撤销 | Ctrl+Z |
| 重做 | Ctrl+Y |
| 剪切 | Ctrl+X |
| 复制 | Ctrl+C |
| 粘贴 | Ctrl+V |
| 查找 | Ctrl+F |
| 替换 | Ctrl+H |
| Format Document | Shift+Alt+F |
提示：复制和粘贴使用系统剪贴板，因此您可以在 QuantCraft 与任何其他应用之间移动代码。
主题
编辑器的配色主题独立于应用的其余部分——您可以让应用使用深色模式，同时使用浅色的编辑器主题，反之亦然。
更改主题
- 打开编辑器顶部的编辑器工具栏。
- 点击 Theme。
- 从列表中选择一个主题。编辑器会立即更新。
您的选择会自动保存，并在您下次打开 IDE 时恢复。
可用主题
Theme 菜单包含一组精选的浅色和深色主题：
- Default Light、Default Dark
- VS Code Light、VS Code Dark （VS Code Dark 为默认）
- GitHub Light、GitHub Dark
- Dracula
- Monokai
- Nord
- Solarized Light、Solarized Dark
- Tokyo Night
- Gruvbox Dark
- Material Light、Material Dark
菜单中的勾选标记表示当前启用的主题。
字体大小
您可以选择编辑器的字体大小以适应您的屏幕和视力，而不会改变应用其他位置的字体大小。
更改字体大小
- 打开编辑器工具栏。
- 点击 Font Size。
- 选择一个大小。编辑器会立即以新的大小重新渲染。
您的选择会在会话之间保留。
可用大小
11 px、12 px、13 px、14 px（默认）、15 px、16 px、18 px、20 px、22 px。
菜单中的勾选标记表示当前启用的大小。
Format Document
Format Document 一步即可整理整个文件——适用于提交更改前、分享代码时，或者只是在工作时保持策略可读。
如何运行
- 打开编辑器工具栏中的 Edit 菜单并选择 Format Document，或者
- 在编辑器获得焦点时按 Shift+Alt+F。
它的作用
- 对于 Python 文件，编辑器使用 QuantCraft 内置的 Python 格式化工具来格式化您的代码。
- 对于 JSON 文件，编辑器会对 JSON 进行美化输出（2 个空格缩进）。也能识别按换行分隔的 JSON，并对每一行进行规范化。
- 如果文件不是有效的 Python 或 JSON，格式化会回退到 Python 格式化工具，这样您仍能得到有用的错误信息。
错误显示在哪里
如果文件无法格式化（例如存在语法错误），编辑器会保持您的代码不变，并将错误信息以红色写入工作区底部的输出面板。修复所报告的问题后，再次运行 Format Document。
提示
- Format Document 不会保存文件——它只是重写缓冲区。如需以新名称保存，请使用 File → Save As…。
- 如果您不喜欢结果，撤销（
Ctrl+Z）可一步还原格式化。 - 格式化命令也已集成到编辑器本身，因此无论您是在菜单中还是在输入代码，Shift+Alt+F 快捷键都能使用。