Sublime怎么配置Python3内核？Sublime解决默认调用Python2问题

Sublime Text 默认调用 python 命令时是 Python 2，因其构建系统依赖系统环境变量中的 python 指向，而多数旧版 Linux/macOS 将 python 指向 Python 2.7；需新建 Python3.sublime-build 文件并显式指定 python3 路径来切换。

Sublime Text 默认调用 python 命令时为什么是 Python 2？

这事儿其实不怪 Sublime Text。它的 Python 构建系统（Build System）设计得很“老实”，默认就是去调用系统环境变量里那个叫 python 的命令。问题出在哪儿呢？在很多老版本的 Linux 或 macOS 系统里，python 这个命令默认指向的就是 Python 2.7。所以，即便你电脑上已经装了 Python 3，并且能在终端里用 python3 命令，Sublime Text 也不会自动去识别和切换——它只认那个默认的 python。

怎么让 Sublime Text 构建时调用 python3 而不是 python？

方法很直接：咱们自己新建一个构建系统配置文件，明确告诉 Sublime Text 该用哪个解释器。跟着下面几步走就行：

• 在 Sublime Text 顶部菜单栏，点击 Tools → Build System → New Build System…
• 把弹出的模板内容清空，然后粘贴下面这段 JSON 配置（注意根据自己系统调整路径）：

{
    "cmd": ["python3", "-u", "$file"],
    "file_regex": "^[ ]*File "(...*?)", line ([0-9]*)",
    "selector": "source.python",
    "encoding": "utf-8"
}

• 保存文件，名字建议用 Python3.sublime-build（后缀 .sublime-build 不能少）。通常，直接保存到默认弹出的 Packages/User/ 目录下最省事。
• 保存后，再回到 Tools → Build System 菜单，就能看到并选择你刚创建的 Python3 配置了。

这里有个关键细节：如果你的 python3 命令不在系统的标准路径（$PATH）里——比如在 macOS 上用了 pyenv 管理版本，或者在 Windows 上安装到了非标准目录——那就不能简单地写 python3，而必须填写绝对路径。例如 macOS 可能是 "/usr/local/bin/python3"，Windows 则类似 "C:\Users\xxx\AppData\Local\Programs\Python\Python311\python.exe"。

为什么改了 Build System 还是报错“command not found: python3”？

这可能是最让人头疼的一步：明明终端里运行得好好的，Sublime Text 却告诉你找不到命令。原因在于，Sublime Text 在 macOS 或 Linux 下启动时，并不会完整加载你在 shell（比如 ~/.zshrc 或 ~/.bash_profile）里设置的环境变量和路径。所以，终端认识的 python3，Sublime Text 可能“看”不到。

解决思路通常有这么几种：

• 使用绝对路径：这是最稳妥、一劳永逸的办法。直接在上面的配置里写上 python3 解释器的完整路径。
• 通过终端启动 Sublime Text：对于 macOS 用户，可以尝试在终端里输入 subl 命令来启动 Sublime Text。这样启动的编辑器会继承当前终端会话的所有环境变量，往往就能识别 python3 了。
• Windows 用户注意路径格式：Windows 平台一般没有上述环境加载问题，但填写路径时要注意反斜杠的转义，或者干脆使用正斜杠。

配置完成后，怎么验证是否成功了呢？新建一个 test.py 文件，里面写上一行 print(3/2)，然后按 Ctrl+B（或 Cmd+B）运行。如果输出结果是 1.5，恭喜你，用的就是 Python 3；如果输出是 1，那说明还在用 Python 2 的整数除法规则，配置还没生效。

能不能让 Sublime 自动识别 .py 文件用 Python 3 构建，不用每次手动选？

当然可以设置自动关联，但这里得泼点冷水：不推荐设置为全局全自动。为什么呢？因为你的工作环境中可能还存在一些依赖 Python 2 的老旧脚本，一刀切地默认使用 Python 3 可能会引发意想不到的问题。

更稳妥的做法是分场景设置：

• 针对单个文件：打开一个 .py 文件后，先点击 Sublime 窗口右下角的语法标识（比如显示着 “Python”），选择 Set Syntax: Python，然后在 Tools → Build System 中手动选择一次 Python3。Sublime Text 通常会记住这个文件对应的构建系统。
• 针对整个项目：如果你在使用项目功能，可以在项目设置（Project → Edit Project）里添加 "build_systems" 字段，来指定该项目默认使用的构建系统名称。
• 重要原则：尽量不要去修改或覆盖默认的 Python.sublime-build 文件。保持它的原样，可以避免影响其他用户，或者某些依赖特定环境的插件正常工作。

话说回来，真正的挑战往往不在配置步骤本身，而在于路径管理和环境隔离。尤其是当你使用了 conda、pyenv、asdf 等工具管理多个 Python 版本时，那个 python3 到底指向哪个解释器，一定要用 which python3（Linux/macOS）或 where python3（Windows）命令确认清楚，凭感觉填写路径是行不通的。