Sublime Text安装与多版本Python路径的手动切换-sublime-PHP中文网

答案：sublime text切换python解释器本质是更换指向不同python可执行文件的.sublime-build构建系统。必须将配置文件存于packages/user/目录，命名合法、json无误，同时设置cmd绝对路径和path环境目录，再通过tools→build system选择，并用sys.executable验证实际路径。

sublime text安装与多版本python路径的手动切换

Sublime Text 里改 Python 解释器，本质是换构建系统

Sublime Text 本身不管理 Python 版本，它只是调用外部 python.exe（Windows）或 python（macOS/Linux）。所谓“切换解释器”，就是换一个 .sublime-build 文件，让它指向你想要的那个可执行文件路径。没有全局设置、没有一键切换按钮，只有手动配构建系统这一条路。

必须把 .sublime-build 放进 Packages/User/ 目录

文件放错位置就完全不生效——Sublime 只扫描固定路径：Packages/User/。其他地方（项目根目录、桌面、Packages/Python/ 子目录）全被忽略。

Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。

下载

最稳操作：菜单栏 Preferences → Browse Packages…，进入弹出的 User 文件夹再保存
Windows 路径示例：%APPDATA%Sublime TextPackagesUser
macOS 路径示例：~/Library/Application Support/Sublime Text/Packages/User/
文件名不能带空格或中文，后缀必须是 .sublime-build（不是 .json 或 .sublime-build.txt）

cmd 和 path 字段缺一不可，尤其虚拟环境

只改 cmd 指向虚拟环境里的 python.exe，但漏掉 path 字段，运行时大概率报 ModuleNotFoundError——因为 Sublime 不会自动把虚拟环境的 Scripts（Windows）或 bin（macOS/Linux）加进 PATH。

Windows 示例（路径含空格必须加引号）：

{
  "path": "C:\myproject\venv\Scripts",
  "cmd": ["C:\myproject\venv\Scripts\python.exe", "-u", "$file"],
  "selector": "source.python"
}

macOS/Linux 示例：

{
  "path": "/Users/you/myproject/venv/bin",
  "cmd": ["/Users/you/myproject/venv/bin/python", "-u", "$file"],
  "selector": "source.python"
}

path 字段值是目录，不是可执行文件；cmd 中的路径推荐用绝对路径，避免歧义

验证是否真用了目标解释器

别信菜单名，要实测。在 Python 文件里写一行：import sys; print(sys.executable)，然后 Ctrl+B 运行。输出路径必须和你 .sublime-build 里写的 cmd 路径一致，才算真正切过去。

常见假成功：菜单里选了 Python3_Custom，但输出还是 /usr/bin/python3 ——说明 .sublime-build 没生效或 JSON 有语法错误
多版本共存时，不同构建系统之间互不影响，但得自己记住哪个文件对应哪个环境
如果 sys.executable 输出的是 python（没路径），说明 cmd 里写的不是绝对路径，Sublime 去系统 PATH 里找了

实际用起来，最麻烦的不是写 JSON，而是每次新建项目都要手动建一个匹配的 .sublime-build；路径写错、后缀名藏了扩展名、JSON 多了个逗号，都会让构建系统消失不见。