sublime text的build system本质是声明式契约，明确指定命令、路径与参数以调用本地解释器/编译器；需手动配置绝对路径、-u参数及working_dir，不自动识别环境，错误多源于路径、环境变量或i/o处理不当。
构建系统不是“运行按钮”，而是你和解释器/编译器之间的契约
Sublime Text 的 Build System 本质是一份明确告诉编辑器“用什么命令、在什么路径、带什么参数去执行当前文件”的声明。它不自动识别 Python 版本，也不帮你找 gcc 在哪——你写什么，它就照做。很多人配完发现按 Ctrl+B 没反应，第一反应是“插件没装好”，其实大概率是构建系统里写的 python3 在终端能跑，但在 Sublime 的沙盒环境里根本找不到这个命令。
- Windows 用户常见错误：构建系统里写
"cmd": ["python", "$file"]，但系统 PATH 里只有python.exe（来自 Anaconda 或 pyenv），而 Sublime 默认继承的是精简版环境变量，python命令压根不存在 - macOS 用户典型坑：用 Homebrew 装的
python3路径是/opt/homebrew/bin/python3，但构建系统里只写了python3，Sublime 启动时没加载 shell profile，导致命令未找到 - Linux 用户易忽略点：构建系统中若用
"shell": true，会走/bin/sh而非bash，某些带source venv/bin/activate的脚本会直接报错
Python 构建系统必须手动指定解释器绝对路径
别信“自动检测”——Sublime 没有 Python 解释器发现机制。你得自己填对路径，否则 input() 卡死、中文输出乱码、虚拟环境不生效，全源于此。
- 查真实路径：在终端执行
which python3（macOS/Linux）或where python（Windows），复制完整输出，比如/usr/local/bin/python3或C:UsersAliceAppDataLocalProgramsPythonPython311python.exe - 构建系统 JSON 中必须用绝对路径：
"cmd": ["/usr/local/bin/python3", "-u", "$file"]，其中-u强制未缓冲输出，解决print()不实时刷屏问题 - Windows 下路径反斜杠要转义：
"cmd": ["C:\Users\Alice\AppData\Local\Programs\Python\Python311\python.exe", "-u", "$file"]，漏掉一个就解析失败 - 不要在
cmd里写cd切目录——构建系统本身支持"working_dir": "$file_path"，这才是正确做法
多环境共存时，构建系统要按需切换，不能靠“猜”
你不会只用一个 Python 解释器。项目 A 用 Poetry 管理的 3.9，项目 B 是系统自带的 3.11，项目 C 还得跑在 Conda 环境里。这时候靠改全局构建系统等于自废武功。
- 为每个环境单独建一个构建系统文件，例如
Python39.sublime-build、CondaBase.sublime-build，放在Packages/User/目录下 - Conda 环境构建系统示例：
"cmd": ["/opt/anaconda3/bin/python", "-u", "$file"]（macOS）或"cmd": ["C:\Users\Alice\anaconda3\python.exe", "-u", "$file"]（Windows） - 切换方式：按
Ctrl+Shift+P→ 输入Build With→ 选对应名称，而不是依赖默认构建系统 - 别把虚拟环境激活逻辑塞进构建系统——
source venv/bin/activate && python -u $file在 Windows 上完全无效，在 macOS/Linux 上也因 shell 差异不可靠
构建系统输出中文乱码、input() 卡死，根本原因只有一个
不是编码设置错了，也不是插件冲突，是 Sublime 的构建面板默认使用的是“原始字节流”管道，没有做终端级的 I/O 处理。它能显示 print()，但无法响应交互式输入，除非你绕过这个限制。
- 中文乱码唯一解法：确保构建系统中
python进程启动时带-u参数，并且你的文件保存为 UTF-8 编码（Sublime 默认就是），无需额外设encoding字段 -
input()卡死无解？有。用subl://协议调外部终端才是正路，例如 macOS 上："cmd": ["osascript", "-e", "tell app "Terminal" to do script "'/usr/local/bin/python3' -u '$file'""] - Windows 上可配合
start cmd /k python -u "$file"，但注意双引号嵌套要严格转义，否则构建系统解析失败 - 别尝试用
shell_exec或第三方插件模拟终端——它们只是把输出重定向到面板，依然不支持 stdin
cmd 背后真实的进程树、环境变量继承关系和 I/O 管道行为。写错一个路径、漏掉一个 -u、误信“自动激活”，都会让整个流程卡在你看不见的地方。
