Sublime便携版无法自动读取系统PATH，必须硬编码Python绝对路径：先用which python3（macOS/Linux）或where python（Windows）获取路径，再新建Build System并填入cmd和path字段，确保保存至DataPackagesUser目录且路径格式正确。
Sublime便携版无法自动读取系统PATH，必须硬编码Python路径
便携版 Sublime Text 不会继承系统环境变量，cmd 里写 python 或 python3 必然报 command not found。它不走 shell，也不查 PATH，只认你写的绝对路径。
实操建议：
- 先在终端运行
where python（Windows）或which python3（macOS/Linux），复制输出的完整路径，比如C:Python312python.exe或/usr/local/bin/python3.12 - 新建构建系统（
Tools → Build System → New Build System…），粘贴以下内容，仅替换cmd第一项：
{
"cmd": ["C:/Python312/python.exe", "-u", "$file"],
"file_regex": "^[ ]*File "(.*)", line ([0-9]*)",
"selector": "source.python",
"encoding": "utf-8"
}
⚠️ Windows 路径用正斜杠 / 或双反斜杠 \，别用单反斜杠 ——JSON 会把它当转义符解析出错。
便携版不保存用户配置到默认位置，Packages/User 是手动指定的
便携版启动时默认把 Packages 指向自身目录下的 DataPackages，不是系统用户目录。如果你按常规操作保存 .sublime-build 到 Preferences → Browse Packages 打开的路径，但没确认它是不是便携版的 DataPackages，那构建系统就永远不会出现在 Tools → Build System 列表里。
立即学习“Python免费学习笔记（深入）”；
实操建议：
- 打开
Preferences → Browse Packages…，看顶部地址栏路径是否含DataPackages；如果不是，说明你正在编辑系统版配置，得手动导航过去 - 确保
.sublime-build文件保存在DataPackagesUser下，且文件名不含空格、中文、括号，例如Python312.sublime-build - 保存后重启 Sublime（便携版有时不热重载构建系统）
用虚拟环境时，path字段不能省，否则import必报ModuleNotFoundError
便携版更不会自动识别项目下的 venv 或 .venv。只改 cmd 指向虚拟环境里的 python.exe 不够，pip、setuptools 和你装的包（比如 requests）都在虚拟环境的 Scripts（Windows）或 bin（macOS/Linux）目录里，Sublime 必须通过 path 字段知道去哪儿找它们。
实操建议：
- Windows 示例（路径含空格也安全）：
{
"path": "D:/myproject/venv/Scripts",
"cmd": ["D:/myproject/venv/Scripts/python.exe", "-u", "$file"],
"file_regex": "^[ ]*File "(.*)", line ([0-9]*)",
"selector": "source.python"
}
- macOS/Linux 示例：
{
"path": "/Users/me/myproject/venv/bin",
"cmd": ["/Users/me/myproject/venv/bin/python", "-u", "$file"],
"file_regex": "^[ ]*File "(.*)", line ([0-9]*)",
"selector": "source.python"
}
path 和 cmd 中的路径必须一致指向同一虚拟环境，否则 import 时找不到包是常态，不是权限或安装问题。
Anaconda插件在便携版里要手动指定解释器，且suppress设置必须关
便携版的 Anaconda 插件不会自动猜 Python 路径，也不会读系统注册表或 pyenv 配置。如果你只装了插件但没改 python_interpreter，补全、跳转、悬停文档全失效，os. 后按 Ctrl+Space 只弹出一堆无关变量名。
实操建议：
- 打开
Preferences → Package Settings → Anaconda → Settings – User - 填入和构建系统中完全一致的 Python 绝对路径，例如：
{
"python_interpreter": "C:/Python312/python.exe",
"anaconda_linting": true,
"suppress_word_completions": true,
"suppress_explicit_completions": true
}
两个 suppress_* 开关不关，Sublime 自带的单词补全会覆盖 Anaconda 的语义补全，这是便携版用户最容易忽略的细节——看起来像插件坏了，其实是配置没对齐。
