在Sublime Text插件中，需继承sublime_plugin.TextCommand并在run(self, edit)中用self.view.substr(sublime.Region(0, self.view.size()))获取当前Python文件全文，避免直接open()或误用on_modified_async。
怎么在插件里获取当前编辑的Python文件内容
Sublime Text 的 Python API 不是让你写独立脚本的，所有代码必须运行在 Sublime 的插件上下文中（即 sublime_plugin.TextCommand 或 sublime_plugin.EventListener 里）。直接在 Python 控制台里调用 view.substr() 会报 AttributeError: 'NoneType' object has no attribute 'substr' —— 因为没拿到有效的 view 对象。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 确保你的类继承自
sublime_plugin.TextCommand，并在run(self, edit)方法里操作self.view - 用
self.view.substr(sublime.Region(0, self.view.size()))读全文件；别用open()手动读磁盘文件，会不同步、不响应编辑器实时修改 - 如果需要处理选区，优先用
self.view.sel()获取Region列表，而不是硬编码坐标
为什么 on_modified_async 拿不到最新代码文本
on_modified_async 触发快，但 Sublime 的内部缓冲区可能还没完成解析 —— 尤其是粘贴大段代码或快速连按退格时，view.substr(view.full_line(0)) 返回的仍是旧内容。这不是你代码写错了，是 Sublime 的异步刷新机制导致的。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 改用
on_post_text_command或on_post_save_async，它们触发时机更稳，适合做 lint、格式化等依赖完整文本的逻辑 - 如果必须用
on_modified_async，加一层简单防抖：用sublime.set_timeout_async(lambda: ..., 50)延迟执行，避开脏缓冲窗口 - 别依赖
view.change_count()来判断是否“真正变了”，它只反映编辑次数，不反映内容是否已同步到 API 可见层
sublime.Region(0, 0) 插入文本后光标位置不对
用 edit.insert() 在 Region 起点插入内容时，Sublime 默认把光标留在插入点**之后**。比如在行首插入 # ，光标会落到 # | 的竖线位置，而不是你期望的 |# —— 这会让用户继续打字时覆盖注释符号。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 插入后手动调整光标：用
self.view.sel().clear()+self.view.sel().add(sublime.Region(pos))，其中pos是插入前的原光标位置 - 更稳妥的做法是用
view.replace(edit, region, new_text)替换空区域，它会自动把光标设在替换内容开头 - 避免在
on_activated里直接操作edit—— 此时 edit 对象可能已失效，会抛RuntimeError: Invalid edit object
插件 reload 后 import 报错 ModuleNotFoundError
Sublime 加载插件时会把插件目录加入 sys.path，但 reload（Ctrl+Shift+P → “Satisfy Dependencies” 或修改保存后自动重载）不会清空已导入模块的缓存。如果你改了 myutils.py 并重载，而主插件仍引用旧版 myutils 的函数签名，就会出现找不到属性或类型错误。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 重载前手动清理：在插件顶部加
import importlib; [importlib.reload(m) for m in list(sys.modules.keys()) if m.startswith('your_plugin_name.')] - 把工具函数写成纯函数、不依赖模块级状态，降低 reload 后的不一致风险
- 避免在
__init__.py里执行耗时初始化（如读配置文件），它会在每次 reload 时重复执行，且无异常捕获兜底
API 行为和编辑器生命周期强耦合，很多问题不是代码逻辑错，而是没对上 Sublime 内部的状态流转节奏。最常被忽略的是 edit 对象的生命周期 —— 它只能在 run() 方法内有效，跨函数传参或存为实例变量都会出问题。
