根本原因是sublime未使用虚拟环境中的python解释器，而是调用系统默认python，导致sys.path不含venv/site-packages；必须手动配置.sublime-build文件，指定cmd指向venv中python绝对路径，并设置path字段为scripts（windows）或bin（macos/linux）目录，同时添加-u参数启用无缓冲输出。
为什么 import 第三方包总报 ModuleNotFoundError
根本原因不是没装包，而是 Sublime 没用你虚拟环境里的 python，它默认调系统 Python 或 PATH 里第一个 python。即使你在终端激活了 venv，Sublime 启动时不继承 shell 环境变量，sys.path 里压根没有你的 venv/site-packages。
验证方式：在 Sublime 里新建 test.py，写 import sys; print(sys.executable); print(sys.path)，Ctrl+B 运行，看输出的解释器路径和 site-packages 是否在你的 venv 目录下。
- 必须手动配置构建系统，
cmd字段指向虚拟环境里的python.exe（Windows）或python（macOS/Linux）绝对路径 -
path字段不能省——它告诉 Sublime 去哪找pip、setuptools和你装的包，Windows 填C:myproject envScripts，macOS/Linux 填/path/to/venv/bin - 路径含空格（如
C:Program Files...）时，cmd中整个路径必须用双引号包裹，比如["C:\Program Files\Python\venv\Scripts\python.exe", "-u", "$file"]
怎么写一个能跑通的 .sublime-build 文件
别复制网上不带 path 的精简版，那基本会 import 失败。下面是最小可用模板，按实际路径改完就能用：
{
"path": "/Users/you/project/venv/bin",
"cmd": ["/Users/you/project/venv/bin/python", "-u", "$file"],
"file_regex": "^[ ]*File "(*?)", line ([0-9]*)",
"selector": "source.python",
"encoding": "utf-8"
}
Windows 用户注意：path 用正斜杠或双反斜杠，cmd 中路径推荐用正斜杠避免转义问题，例如 "C:/project/venv/Scripts/python.exe"。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 保存为
Python-venv.sublime-build，必须放在Packages/User/目录（Preferences → Browse Packages 可直达） - 文件名不能有空格或中文，否则 Sublime 加载失败
- JSON 格式要严格合法——末尾不能多逗号，字符串必须双引号，用在线 JSON 校验器过一遍
为什么加 -u 参数是刚需
不加 -u，print() 输出会缓冲，Ctrl+B 运行后控制台“没反应”，等几秒才刷出结果；更严重的是，遇到 input() 直接抛 IOError: [Errno 0] Error，脚本卡死。
-
-u强制无缓冲输出，让 Sublime 构建面板行为接近终端 - 别写成
--unbuffered，Sublime 不识别长选项 - Windows 下
python.exe -u和 macOS/Linux 下python -u效果一致 - 某些依赖
sys.stdout.isatty()的库（如click）仍可能降级，这不是-u能解决的，属于 Sublime 构建面板非 TTY 的固有限制
项目切换时容易忽略的关键点
Sublime 不自动感知当前项目目录下的 venv，也不会根据打开的文件夹自动切构建系统。你得手动绑定，否则换个项目就又跑错环境。
- 用
Project → Save Project As…保存.sublime-project文件，在里面指定构建系统："build_systems": [{"name": "Python-venv"}] - 下次直接通过
Project → Open Project打开这个项目，构建系统自动选中，不用每次手动切 - 别指望“全局设置里填 python_interpreter”——Anaconda 插件早就不维护了，且配置项只影响代码提示，不影响实际运行
- 改完构建系统或项目文件后，重启 Sublime 或关闭再重开项目，避免缓存导致配置未生效
最麻烦的不是写对路径，而是每次换项目都得确认构建系统是否真的用了你那个 venv 的 python——运行 import sys; print(sys.executable) 是唯一靠谱的验证方式。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
