Sublime Text 的 Python 构建系统需显式配置绝对路径和环境变量：cmd 用 python 解释器绝对路径，path 字段设虚拟环境 Scripts/bin 目录，Anaconda 的 python_interpreter 必须与之完全一致，否则导致模块导入失败、补全/跳转异常。
Sublime Text 的 Python 构建系统不读系统 PATH
直接写 python 或 python3 在 "cmd" 里，大概率失败——Windows 可能找不到命令，macOS/Linux 可能调用到系统自带的旧版（比如 macOS 自带的 Python 2.7），而不是你装的 Python 3.12。Sublime 启动时不会继承终端环境变量，也不解析 shell 的 $PATH，它只认你硬写的路径或当前 shell 环境中可执行的命令名（且仅限于没加 -u 等参数时的简单调用）。
实操建议：
- 先在终端运行
which python3（macOS/Linux）或where python（Windows），拿到真实路径，例如/opt/homebrew/bin/python3或C:/Users/Alice/AppData/Local/Programs/Python/Python312/python.exe - 构建系统中
"cmd"必须用绝对路径，反斜杠要双写或改用正斜杠；含空格路径必须整个用双引号包裹，如"C:/Users/My Name/AppData/Local/Programs/Python/Python312/python.exe" - 别依赖“激活虚拟环境后启动 Sublime”——那只是骗过终端，Sublime 进程完全不知道你 activate 过什么
虚拟环境路径必须显式配置 path 字段
只改 "cmd" 指向虚拟环境里的 python.exe 或 python，不够。import 第三方包（比如 snap7、django）仍会报 ModuleNotFoundError，因为 Sublime 不会自动把虚拟环境的 Scripts（Windows）或 bin（macOS/Linux）加进子进程的 PATH 环境变量。
实操建议：
- Windows 示例：
"path": "C:/myproject/venv/Scripts"，且"cmd"中也要用该目录下的python.exe - macOS/Linux 示例：
"path": "/Users/you/myproject/venv/bin"，"cmd"用该目录下的python -
path字段不是可选的——它是让pip、setuptools和所有通过pip install安装的包能被找到的关键
多个 Python 版本共存时，构建系统命名和存放位置决定优先级
Sublime 不会按“最新安装”或“路径顺序”自动选解释器。它只按 Tools → Build System 菜单里列出的顺序启用，而这个顺序由文件名和保存位置决定：放在 Packages/User/ 目录下的 .sublime-build 文件，按字母序排在最前；以 Python - projectA.sublime-build 命名，就比 Python3.sublime-build 更容易被人工选中。
实操建议：
- 每个项目单独建一个构建系统文件，命名如
Python - myapi.sublime-build，避免混用 - 文件名不要含空格或中文，否则 Sublime 可能加载失败或菜单里显示异常
- 保存路径必须是
Packages/User/（可通过 Preferences → Browse Packages → User 进入），放错位置不会出现在菜单里
Anaconda 插件的 python_interpreter 必须与构建系统完全一致
补全失效、跳转错行、lint 报错但运行正常——八成是因为 Anaconda 插件里设的 python_interpreter 和你构建系统用的不是同一个 Python 解释器。它们俩必须指向同一路径，否则语义分析和实际执行环境脱节。
实操建议：
- 打开 Anaconda 设置（Preferences → Package Settings → Anaconda → Settings – User），填入和构建系统里
"cmd"完全一致的路径，例如"python_interpreter": "/opt/homebrew/bin/python3" - 同时设
"suppress_word_completions": true和"suppress_explicit_completions": true，否则 Sublime 原生补全会和 Anaconda 冲突 - 改完设置后重启 Sublime，或手动重载 Anaconda 插件（Ctrl+Shift+P → “Anaconda: Reload Plugin”）
真正容易被忽略的是：构建系统里的 path 字段和 Anaconda 的 python_interpreter 是两套独立配置，改了一个另一个不动，问题就还在。版本冲突从来不是“哪个 Python 更高”，而是“哪条路径被谁用了”。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
