QEditor 代码补全——上下文感知的智能提示

补全能做什么

代码补全（Code Completion / Auto-completion）在你输入代码时，根据当前上下文弹出一个候选列表，帮你快速选中要输入的函数名、变量名、关键字等，减少手动敲字量，也避免拼写错误。

QEditor 支持的补全类型

Python 关键字补全

输入前几个字符后，自动匹配 Python 关键字（def、class、import、return 等）。这是最基础的一层，所有 Python 编辑器都有。

内置函数补全

print、len、range、str、list 等内置函数，以及已导入模块的方法都会出现在补全列表里。

已导入模块的成员补全

这是最实用的一层。比如你已经 import numpy as np，输入 np. 后会自动弹出 numpy 的所有属性和方法。具体能补全到什么程度取决于 QEditor 对模块的静态分析能力——标准库和常见第三方库的补全通常比较完整。

代码片段（Snippets）

部分版本的 QEditor 内置了常用代码片段，比如：

• 输入 def 后可能自动补全函数骨架
• 输入 class 后自动补全类骨架
• 输入 import 后给出常用导入建议

片段补全在桌面 IDE（VS Code、PyCharm）里非常强大，QEditor 在移动端也提供了基础版本。

Android API 补全

如果你在 QEditor 里导入了 androidhelper，QSL4A 的常见方法名应该会出现在补全列表里。实际效果取决于 QEditor 对 QSL4A 的内建支持程度。

补全触发方式

QEditor 中的代码补全通常在以下情况自动弹出：

• 输入 . 之后（模块或对象的属性访问）
• 输入 ( 或空格时
• 手动触发（部分版本需要按特定按钮或从菜单选择）

补全候选弹出后，可以上下滑动选择，点击或按回车确认选中。选中的同时会自动在光标位置插入选中项。

移动端输入的特殊体验

手机上敲代码的一个大痛点是输入法频繁切换——在中文输入法下敲 Python 关键字需要先切到英文。QEditor 的代码补全在一定程度上缓解了这个问题：

• 弹出的候选列表不需要敲英文，可以直接点击选择
• 底部扩展键盘条的一键符号按钮也减少了切输入法的次数
• 部分输入法支持在代码编辑器中自动切换到英文模式（如 GBoard）

补全效果的边界

需要坦诚说明：QEditor 的代码补全能力远不如桌面 IDE（VS Code、PyCharm）。具体限制：

• 动态类型推断有限：Python 是动态类型语言，静态分析很难精确推断变量类型，补全只能基于已有的 import 和模块已知接口
• 第三方库覆盖率有限：冷门库的方法可能不在补全列表里
• 复杂项目分析能力弱：跨文件的项目级补全（如从 utils.py 跳到定义再返回）基本不支持

对于手机上的轻量级开发，这些限制通常可以接受。如果是大型项目，建议在 PC 上用完整 IDE 开发，手机上用 QPython 做调试和运行验证。

开启和关闭补全

部分版本的 QEditor 在设置里提供了补全开关。如果你觉得补全弹窗挡住了输入，可以临时关闭。但建议始终开启——移动端敲一个字母比 PC 上麻烦得多，补全省下来的敲字量是实打实的。

小结

QEditor 的代码补全虽然不如桌面 IDE 强大，但在移动端已经够用了。关键字、内置函数、已导入模块的成员补全都能正常工作，能显著减少手动敲字量，降低拼写错误。配合底部扩展键盘条，移动端写 Python 的体验被拉到了一个实际可用的水平。

继续看 多标签管理 了解如何同时编辑多个文件。