sublime text 无法原生运行 python 异步代码，需通过 asyncio.run() 显式启动事件循环或自定义 build system 使用 python -m asyncio；await 只能在 async def 内使用，且必须配合可等待对象。
Sublime Text 本身不支持原生 Python 异步运行（比如直接按 Ctrl+B 运行 async def 函数会报错 SyntaxError: 'await' outside async function 或直接崩溃），它只是一个编辑器，不是运行环境。真正执行 asyncio 代码，靠的是你本地安装的 Python 解释器和正确的运行方式。关键不是“Sublime 怎么异步编程”，而是“如何在 Sublime 编辑环境下，正确编写、调试并运行 Python 异步代码”。
理解 asyncio 和 await 的本质
asyncio 是 Python 标准库提供的异步 I/O 框架，核心是事件循环（event loop）；await 不是让代码“变快”，而是告诉解释器：“这里我要等一个可等待对象（如协程、Future、Task），但别阻塞整个线程，可以先去干别的事”。它只能出现在 async def 定义的协程函数内部。
- 普通函数用
def，调用立即执行，返回结果 - 协程函数用
async def，调用后返回一个协程对象（coroutine object），必须交给事件循环驱动才能真正运行 -
await后面必须是可等待对象（awaitable），比如另一个协程、asyncio.sleep()、loop.run_in_executor()返回的 Future 等
在 Sublime 中正确运行 async/await 代码
不能直接用 Sublime 默认的 Build System（Python.sublime-build）运行含 await 的脚本，因为默认是同步执行：python filename.py —— 这会触发 RuntimeError: asyncio.run() cannot be called from a running event loop 或直接语法报错（如果顶层用了 await）。
- ✅ 正确做法：在脚本末尾显式启动事件循环，例如：
async def main():
print("Hello")
await asyncio.sleep(1)
print("World")
# 必须这样启动
if __name__ == "__main__":
asyncio.run(main())
- ✅ 更灵活的方式：自定义 Sublime Build System，用
python -m asyncio（Python 3.7+ 支持）自动处理顶层 await（实验性，适合简单脚本）：
新建 Tools → Build System → New Build System，写入：
"shell_cmd": "python -m asyncio ${file}",
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python"
}
- ⚠️ 注意：该方式不支持交互式输入，也不适合含复杂初始化逻辑的项目
调试异步代码的小技巧（Sublime + 手动辅助）
Sublime 没有内置 async 调试器，但你可以结合 print、logging 和 asyncio 提供的工具辅助定位问题：
立即学习“Python免费学习笔记（深入）”；
- 用
asyncio.current_task()和asyncio.all_tasks()查看当前任务状态 - 在关键 await 前后加
print(f"[{time.time():.2f}] before/after")观察调度时机 - 避免在协程里用
time.sleep()（会阻塞整个事件循环），改用await asyncio.sleep() - 若需同步阻塞操作（如 requests.get），用
loop.run_in_executor()托管到线程池，防止拖慢异步流
常见误区与避坑提醒
很多人卡在“写了 async 却没效果”，其实问题常出在执行层或逻辑设计：
- ❌ 在普通函数里写
await→ 报SyntaxError - ❌ 直接调用协程函数（
main()）却不 await 或不 run → 只创建协程对象，不执行 - ❌ 多个 await 串行写，却误以为是并发 → 实际仍是顺序等待，要用
asyncio.gather()或asyncio.create_task() - ❌ 在 Jupyter 或某些 IDE 的交互环境中粘贴 async 代码，忘了用
%run或await显式驱动 → 会静默失败
基本上就这些。Sublime 是称职的异步代码“书写器”，不是“执行器”或“调试器”。把逻辑写对、事件循环启对、await 用对，剩下的交给 Python 解释器就好。
