Sublime Text运行Python需正确配置解释器路径、环境隔离和UTF-8编码：先查真实python路径，新建Build System填绝对路径并加-u和-X utf8参数；虚拟环境需用其内python路径；补全失效需配.jedi文件且python_interpreter与Build System一致；避免中文路径。
Python解释器路径配不对，Ctrl+B 一运行就报 Unable to find python command
Sublime Text 本身不自带 Python 运行环境，它只是调用系统已安装的 python 或 python3 命令。Windows 用户尤其容易卡在这一步——系统 PATH 里没加 Python，或者装了多个版本但 Sublime 默认找的是旧版或不存在的路径。
实操建议：
- 先在终端（CMD/PowerShell/Terminal）里运行
which python3（macOS/Linux）或where python（Windows），确认实际可执行文件路径，比如/usr/local/bin/python3或C:UsersNameAppDataLocalProgramsPythonPython311python.exe - 打开 Sublime Text →
Tools→Build System→New Build System…，粘贴以下内容（按你的真实路径改）：
{
"cmd": ["<code>你的python路径</code>", "-u", "$file"],
"file_regex": "^[ ]*File "(...*?)", line ([0-9]*)",
"selector": "source.python"
}
注意："cmd" 里必须写绝对路径；Windows 下反斜杠要双写（C:\Python311\python.exe）或改用正斜杠（C:/Python311/python.exe）；别漏掉 -u 参数，否则 print 输出可能延迟或乱码。
想用 pip install 装的包，但 import 就报 ModuleNotFoundError
不是包没装成功，而是 Sublime 的构建系统默认用的 Python 解释器和你终端里 pip install 的不是同一个环境。常见于：用 pyenv、conda、venv 管理环境，但 Sublime 没指向激活后的解释器。
立即学习“Python免费学习笔记（深入）”；
实操建议：
- 进你项目所在的虚拟环境（如
source venv/bin/activate或conda activate myenv），再运行which python，拿到该环境下的解释器路径 - 把这个路径填进上一步的 Build System 配置里，而不是系统全局 Python 路径
- 如果项目依赖多个环境，建议为每个项目单独建一个 Build System 文件，命名如
Python - myproject.sublime-build，避免混用
代码补全和跳转失效，goto definition 点不动
Sublime Text 原生不带 Python 语言服务器，靠插件（如 SublimeJEDI 或 anaconda）提供智能提示。但这些插件默认只扫描当前文件夹，跨目录 import 或使用第三方包时容易“看不见”。
实操建议：
- 装好
SublimeJEDI后，在项目根目录下加一个.jedi文件，内容写："sys_path": ["./src", "./lib", "/path/to/your/site-packages"]
（路径按需调整） - 确保
python_interpreter配置和 Build System 一致，否则补全用的解释器和运行时的不一致，类型推导就错位 - 禁用
anaconda插件（已停止维护），它和现代 Python 版本兼容性差，且会干扰SublimeJEDI
中文路径或文件名下运行报 UnicodeDecodeError
Windows 上最典型：项目放在桌面或“文档”这类含中文名的路径里，python 解释器启动时默认用系统编码（GBK）读取源码，但文件是 UTF-8 编码，直接崩。
实操建议：
- 在 Build System 的
"cmd"数组末尾加参数："-X", "utf8"（Python 3.7+ 支持），强制解释器用 UTF-8 解码源文件 - 或者更稳妥：把项目移到纯英文路径下（如
D:/code/myproject），彻底避开编码争议 - 不要依赖
# -*- coding: utf-8 -*-注释——它只影响字符串字面量，不解决文件读取阶段的解码问题
真正麻烦的从来不是配置项本身，而是解释器路径、环境隔离、编码这三者之间的隐式耦合。改完一个地方，另外两个可能就悄悄脱节了。
