Sublime显示当前函数名_Sublime状态栏插件增强配置方法

Sublime Text 原生不支持在状态栏实时显示当前函数名——这是很多开发者在深度使用后才会发现的硬伤。所有“显示函数名”的效果，本质上都依赖插件配合事件监听，而且必须手动处理作用域提取和更新时机。直接装个插件不配置，大概率只在部分文件里闪一下就消失，跟没有一样。

先说说为什么像 Status Bar Manager 或 StatusBarEnhanced 这类通用状态栏插件，永远显示不了函数名。它们只处理固定元信息，比如文件编码、Git 分支、行尾符这些静态内容，根本不去解析代码结构。说白了，它们没有 AST 解析能力，也不监听光标移动事件，对“当前函数”这种动态上下文完全无感。你装了 StatusBarGit 能看到 main 分支，但别指望它自动冒出 def parse_config()。

• 这些插件的字段列表（status_bar_items）里，压根没有 function_name 这个 key。
• 即便你强行加进去，插件内部没实现提取逻辑，最终显示为空或默认占位符。
• 某些旧教程提到的 status_bar_extras 插件已经多年没更新，Sublime Text 4 下基本不可用，调用 view.scope_name() 返回空字符串是常态。

那么，真正能落地的是什么方案？目前最稳定的做法是：用 ScopeHunter 结合自定义 Python 插件。ScopeHunter 负责准确识别光标所在的语法作用域（比如 source.python meta.function.python），而 Python 插件负责从该作用域中提取函数或方法名，写入状态栏。

• 先安装 ScopeHunter：命令面板输入 Package Control: Install Package → 搜 ScopeHunter 安装。
• 然后在 Packages/User/ 下新建 function_status.py，内容如下：

import sublime
import sublime_plugin
import re

class FunctionNameStatus(sublime_plugin.EventListener):
    def update_function_status(self, view):
        if not view.is_primary():
            return

        # 获取光标位置的作用域
        scope = view.scope_name(view.sel()[0].begin())

        # 匹配函数/方法定义（适配 Python/JS）
        if "source.python" in scope:
            pattern = r"^\s*def\s+(\w+)|^\s*class\s+(\w+)"
        elif "source.js" in scope or "source.ts" in scope:
            pattern = r"^\s*(?:function\s+(\w+)|const\s+(\w+)\s*=\s*function|(\w+)\s*=\s*\(.*?\)\s*=>)"
        else:
            view.erase_status("function_name")
            return

        line = view.substr(view.line(view.sel()[0].begin()))
        match = re.search(pattern, line)
        name = match.group(1) or match.group(2) or match.group(3) if match else None

        if name:
            view.set_status("function_name", f"? {name}")
        else:
            view.erase_status("function_name")

    def on_selection_modified_async(self, view):
        self.update_function_status(view)

    def on_activated_async(self, view):
        self.update_function_status(view)

这里面有几个关键点需要留意。on_selection_modified_async 确保光标移动时刷新状态栏，on_activated_async 防止切换标签页后功能失效。正则只匹配当前行开头，避免跨行误判。不依赖 view.extract_scope()，因为它在注释或字符串内也会返回函数作用域，反而容易出错。此外，view.erase_status("function_name") 必须显式调用，否则光标移出函数体后，状态栏仍然残留旧的函数名。

你可能会问，那为什么不直接用 Ctrl+R？Ctrl+R 是符号索引面板，本质上是 Sublime 内置的 symbol_list 功能。它读取的是文件内所有 def、function、class 行的静态快照，不随光标实时变化。它不走状态栏 API，也不触发 set_status，所以无法被复用到状态栏上。具体来说：它不监听事件，只在打开瞬间扫描一次；光标移动后内容不会更新。它的输出格式是纯文本列表，无法提取为结构化字段供状态栏使用。如果想让它与状态栏同步，你得自己重写一遍符号解析逻辑——这比用 ScopeHunter 提取作用域更重、更复杂，也更容易出错。

最后说一下容易被忽略的兼容性陷阱。函数名提取看起来简单，但在真实项目中极易断裂。不同语言的缩进风格、装饰器、箭头函数、TypeScript 接口方法、JSDoc 注释块，都会干扰正则匹配。最稳妥的做法不是写一个通用正则，而是按需分语言维护提取逻辑，同时接受“部分场景不显示”比“错误显示”更合理。

• Python 中，@decorator 在 def 上方时，view.line() 只取到装饰器行，需要向上遍历多行才能找到真正的函数定义。
• Ja vaScript 中，const fn = () => {} 和 function fn() {} 的作用域标记相同，但正则写法无法共用。
• Sublime 的 scope_name() 在 JSX/TSX 文件中可能返回 source.js.jsx，需要额外判断。
• 状态栏的 key（比如 "function_name"）必须全局唯一。如果同时启用 SublimeCodeIntel，它也可能用同名 key，导致互相覆盖。