Sublime Text必须手动配置构建系统和语言服务器指向venv中Python解释器绝对路径，否则import失败、LSP报错、subprocess调用系统Python；关键操作包括：新建.sublime-build文件指定cmd为venv/Scripts/python.exe（Windows）或venv/bin/python（macOS/Linux），设working_dir为$project_path，同时在.pyrightconfig.json中配置python.defaultInterpreter为相对路径并重启Pyright服务。
如何让Sublime Text识别并运行venv里的Python解释器
Sublime Text默认不自动感知项目级venv，必须手动指定解释器路径，否则import会失败、LSP报错、subprocess.run()调用的仍是系统Python。
关键不是“配置插件”，而是让构建系统和语言服务器都指向venv/bin/python（macOS/Linux）或venv\Scripts\python.exe（Windows）：
- 打开项目根目录，在
.sublime-project文件中添加"settings"块，写入"python_interpreter"绝对路径（推荐用$project_path变量避免硬编码） - 如果用
SublimeREPL，启动时选Python → Python - venv，它会尝试读取venv目录，但更可靠的是在REPL设置里手动填入venv内Python路径 - 若使用
Pyright或Pylsp，它们依赖pyproject.toml或pyrightconfig.json中的"python.defaultInterpreter"，值应为./venv/bin/python（注意是相对路径，且需确保工作目录正确）
为什么Ctrl+B构建时还是跑错Python版本
Sublime Text的构建系统（Build System）默认不继承shell环境，也不会自动查找venv——它只认你明确指定的cmd或target。
常见错误现象：ModuleNotFoundError: No module named 'requests'，但你在venv里明明pip install requests过了。
立即学习“Python免费学习笔记（深入）”；
- 不要复用默认的
Python构建系统；新建一个Tools → Build System → New Build System - 内容至少包含：
{ "cmd": ["./venv/bin/python", "-u", "$file"], "file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)", "selector": "source.python", "working_dir": "$project_path" }（Windows请把./venv/bin/python换成./venv/Scripts/python.exe） -
"working_dir"必须设为$project_path，否则./venv会相对于当前打开的文件路径解析，容易出错
Pyright提示“Import ‘xxx’ could not be resolved”
Pyright不靠PATH或激活状态，它需要明确知道venv位置才能索引第三方包。即使构建能跑通，类型检查仍可能失效。
最简解法是在项目根目录建pyrightconfig.json：
{
"python.defaultInterpreter": "./venv/bin/python",
"include": ["."]
}注意两点：
-
python.defaultInterpreter路径必须存在且可执行；如果用poetry或pdm管理venv，路径可能是./.venv/bin/python或./.pdm-python，得实际确认 - 改完配置后，必须重启Pyright服务（命令面板搜
Pyright: Restart Server），否则缓存继续报错 - 如果项目有
src/结构，还需加"extraPaths"指向src，否则本地模块导入标红
用快捷键运行单个函数时找不到venv依赖
这类操作（比如用SublimeCodeIntel或Exec插件选中函数后运行）本质是新开子进程执行，不会加载venv的site-packages。
根本原因：没指定解释器，或用了sys.executable（它返回的是Sublime主进程的Python，通常是内置的3.3）。解决方式很直接：
- 所有自定义命令（如
sublime_plugin.TextCommand）里，调用subprocess.run()时，第一参数必须是./venv/bin/python完整路径，不能写'python' - 如果插件支持配置项（如
SublimePythonIDE），查文档找类似"python_binary"的设置项，填绝对路径 - 别信“激活venv再启动Sublime”的说法——Sublime不读shell的
activate脚本，该错还是错
真正麻烦的点在于：不同插件读配置的位置五花八门，有的看.sublime-project，有的只认Preferences.sublime-settings，还有的硬编码了/usr/bin/python3。遇到问题先print(sys.executable)确认实际调用的是哪个Python。
