Sublime Text 运行 Python 报错90%是构建系统未正确调起解释器，因其不读系统PATH、不继承shell环境，需手动配置绝对路径的Python3构建系统并选中启用。
Sublime Text 运行 Python 报错，90% 的情况不是代码问题，而是构建系统（Build System）压根没调起 Python 解释器——它连启动都失败了，自然没有报错堆栈、也没有输出。
为什么 Ctrl+B 按下去没反应或报 “python: command not found”
根本原因是 Sublime 不读系统 PATH，也不会继承 shell 环境变量。它只认你 build system 配置里写的路径，或者系统 PATH 中能被直接执行的命令名。
- 终端里
python --version成功 ≠ Sublime 一定能用python：macOS/Linux 上 Homebrew/pyenv 安装的 Python 通常只有python3；Windows 上 Anaconda 或手动安装可能只注册了python3.exe，而没设python软链接 - build system 文件保存位置错误：必须放在
Packages/User/目录下，否则 Sublime 根本不加载 - 菜单里选了 “Automatic”：即使你新建了
Python311.sublime-build，如果顶部菜单显示的是 Automatic，Ctrl+B 就会走默认（可能已损坏）的构建系统 - 文件没识别为 Python：右下角状态栏没显示 “Python”，
selector就不匹配，构建系统不会触发
怎么写一个靠谱的 Python3 构建系统（cmd + path + -u）
别抄网上泛用的 "shell_cmd": "python -u \"$file\""，它在多版本、虚拟环境、空格路径下极易崩。推荐用 "cmd" 数组 + 绝对路径 + -u 参数的组合。
- 先用终端确认真实路径：
which python3（macOS/Linux）或where python3（Windows），拿到类似/opt/homebrew/bin/python3或C:/Users/Alice/AppData/Local/Programs/Python/Python311/python.exe的结果 -
"cmd"必须是数组格式，路径用正斜杠（Windows 也推荐）、含空格时无需额外引号（JSON 字符串本身已包裹） - 务必加
-u：避免print()输出卡住不刷新，看着像程序挂了 - 可选
"path"字段：填解释器所在目录（如/opt/homebrew/bin），用于解决某些包依赖需从该路径找二进制的情况 - 示例（macOS）：
{ "cmd": ["/opt/homebrew/bin/python3", "-u", "$file"], "file_regex": "^[ ]*File \"(*?)\", line ([0-9]*)", "selector": "source.python", "path": "/opt/homebrew/bin" }
用虚拟环境里的 Python 怎么配才不踩坑
别把 venv/bin/python 路径硬写进 build system —— 换个项目就得改配置，且无法自动响应 activate 后的环境变量变化。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记（深入）”；
- 真正可行的轻量方案：用 shell wrapper（macOS/Linux）或 bat 脚本（Windows）封装激活 + 执行逻辑，然后在 build system 的
"cmd"里调这个脚本 - Windows 示例（save as
run_venv.bat）：@echo off call C:\myproject\venv\Scripts\activate.bat python -u %1
，然后 build system 写"cmd": ["C:/myproject/run_venv.bat", "$file"] - 注意：Sublime 的构建系统不会执行
source或activate，它只调用单个可执行文件，所以必须靠外部脚本兜底 - 如果只是临时测试，直接写绝对路径能跑，但长期维护成本高
中文乱码、缩进报错、NumPy 导入失败——它们和构建系统有关吗
有关，但不是同一层问题。构建系统只管“能不能启动解释器”，后续行为由解释器自身和文件上下文决定。
- 中文乱码：大概率是 Windows 控制台编码（GBK）和 Python 文件 UTF-8 不一致，加
# -*- coding: utf-8 -*-声明 + build system 加"encoding": "utf8"可缓解 - TabError：和构建系统无关，是文件混用了 Tab 和空格。必须关掉
detect_indentation，再通过Convert Indentation to Spaces清理历史缩进 - ModuleNotFoundError（如 numpy）：说明构建系统调起了某个 Python，但它不是你装了库的那个。验证方式：在终端里用同一路径的 Python 执行
python -c "import numpy"；若失败，就不是 Sublime 的问题，而是环境没装对
最常被忽略的点：改完 build system 后，一定要手动在 Tools → Build System 菜单里点选它，而不是留着 Automatic；并且确保当前文件后缀是 .py、右下角状态栏显示 “Python” 语法高亮——这两项不满足，配置再准也没用。
