sublime text无法自动识别pyenv设置的python版本，必须通过shell启动继承环境：macos用open -a "sublime text"，linux用终端运行subl；绑定poetry虚拟环境需手动配置build system和linter路径为venv内绝对路径。
Sublime Text 怎么自动识别 pyenv 设置的 Python 版本
Sublime Text 本身不感知 pyenv，它只认 PATH 里第一个可用的 python。所以关键不是“让 Sublime 读 pyenv”，而是让 Sublime 启动时继承你 shell 里已激活的 pyenv 环境。
常见错误现象：终端里 pyenv version 显示 3.11.9，但 Sublime 的 Ctrl+` 控制台里 import sys; print(sys.version) 却是系统默认的 2.7.18 或旧版 3.9 —— 这说明 Sublime 没走你的 shell 配置。
- macOS：确保用
open -a "Sublime Text"启动（而非从 Dock 或 Finder 双击），这样会加载 shell 的~/.zshrc或~/.bash_profile - Linux：从终端运行
subl启动；如果桌面快捷方式打不开，检查其Exec=是否指向/usr/bin/subl而非硬编码的/opt/sublime_text/sublime_text - Windows 不适用 pyenv，跳过
如何让 Sublime Text 的 Build System 绑定 poetry 创建的虚拟环境
Pyenv 管版本，Poetry 管依赖和 venv，两者不冲突，但 Sublime 的 Python.sublime-build 默认只调 python，不会进 Poetry 的 .venv。必须显式指定解释器路径。
操作步骤：
- 在项目根目录运行
poetry env info --path，得到类似/Users/me/.cache/pypoetry/virtualenvs/myproject-py3.11的路径 - 复制该路径，新建
ProjectName.sublime-build文件，内容为：
{
"cmd": ["<code>/Users/me/.cache/pypoetry/virtualenvs/myproject-py3.11/bin/python</code>", "-u", "$file"],
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python"
}
注意：bin/python 在 macOS/Linux，Windows 是 Scripts\python.exe；路径中不能有波浪号 ~，必须写绝对路径。
为什么 Sublime 的 auto-complete 和 linter（如 SublimeLinter-flake8）总报“module not found”
因为 Sublime 插件运行在自己的 Python 进程里，不自动继承当前项目的 Poetry venv。比如 flake8 装在 venv 里，但插件调的是全局 flake8，自然找不到 requests 这类本地依赖。
解决方法分两步：
- 确认
flake8（或pylint、mypy）已安装在当前 Poetry venv 中：poetry run which flake8 - 在 SublimeLinter 设置中（
Preferences → Package Settings → SublimeLinter → Settings），修改paths或linters.flake8.executable：
"linters": {
"flake8": {
"executable": "/Users/me/.cache/pypoetry/virtualenvs/myproject-py3.11/bin/flake8"
}
}
别用 poetry run flake8 —— SublimeLinter 不支持 shell 命令链，只接受可执行文件路径。
切换 Poetry 环境后，Sublime 的 Build 和 Lint 为何没自动更新
Sublime 不监听 poetry install 或 poetry env use，所有路径都是静态配置的。每次换 Python 版本或重装依赖，都得手动刷新：
- 重新运行
poetry env info --path，更新.sublime-build和 linter 配置里的路径 - 如果用了
SublimeJEDI或anaconda补全插件，还要在插件设置里指定python_interpreter为同一 venv 的bin/python - 重启 Sublime（仅改配置文件有时不生效，尤其 linter 缓存）
真正省事的方式是：把 poetry env info --path 封装成 shell 函数，配合 subl --project 启动时自动注入路径——但这需要自定义插件，超出轻量协作场景的必要性。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
