根本原因是Sublime Text默认用系统环境变量启动Python，未继承终端路径上下文，导致工作目录为安装路径或主目录而非文件所在目录；需在Build System中设置"working_dir": "$file_path"并确保包结构正确。
为什么 subl 命令运行 Python 时总报 “No module named xxx”
根本原因不是 Sublime Text 本身的问题，而是它默认用系统环境变量启动 Python，而没继承你当前终端的路径上下文。你在终端里 cd 到项目目录再运行 python main.py 能成功，但用 Sublime 的 Ctrl+B（Build）直接跑，Python 就找不到同级的 utils.py 或 config/ 目录——因为工作目录（os.getcwd()）默认是 Sublime 的安装路径或用户主目录。
改 Build System：让 Python 工作目录等于文件所在目录
打开 Tools → Build System → New Build System…，贴入以下内容并保存为 Python-relative.sublime-build：
{
"cmd": ["python", "-u", "$file"],
"file_regex": "^[ ]*File "(...*?)", line ([0-9]*)",
"working_dir": "$file_path",
"selector": "source.python"
}
关键点：
-
"working_dir": "$file_path"强制把工作目录设为当前 Python 文件所在文件夹，这样open("data.txt")、import mymodule全部按相对路径解析 -
"cmd"里用$file（完整路径）而非$file_name，避免只传文件名导致找不到 - 别用
python3硬编码——如果你的python命令指向的是 Python 3.9+，就不用改；如果报python: command not found，换成"cmd": ["/usr/local/bin/python3", "-u", "$file"]（macOS）或["C:\Python39\python.exe", "-u", "$file"]（Windows）
遇到 import 报错？检查 __init__.py 和包结构
即使工作目录对了，from utils.helper import foo 还是失败，大概率是包导入问题。相对导入只在模块被当作包一部分执行时才生效，而 Sublime 的 Build 默认是“脚本式执行”，不是 python -m package.main。
立即学习“Python免费学习笔记（深入）”；
两种解法：
- 最简单：所有
import改成绝对路径风格，确保utils/同级有__init__.py，且你的文件在utils/外层（即project/main.py和project/utils/__init__.py），这样import utils.helper才有效 - 进阶：改 Build System 用
-m模式运行，但必须保证$file是包内模块，且working_dir设为包根目录（比如项目根），否则-m会找不到模块 - 别依赖
sys.path.append('..')—— 它在 Build 下可能因路径不一致而失效，且污染全局路径
Mac/Linux 下 subl 命令没反应？其实是 Shell 环境隔离
Sublime 通过 GUI 启动时，不会加载你 shell 配置（如 ~/.zshrc），所以 subl 命令可用，但里面调用的 python 可能不是你 which python 看到的那个。
验证方式：在 Build System 里临时加一行 "cmd": ["which", "python"]，看输出路径。如果不对，有两个选择：
- 在 Build System 的
"cmd"中直接写死 Python 绝对路径（推荐，稳定） - 或者用 LaunchAgent 让 GUI 应用继承 shell 环境（复杂，容易出错，不建议初学者折腾）
真正麻烦的从来不是怎么配 Sublime，而是 Python 的模块解析规则和 GUI 进程的环境隔离——这两者叠在一起，一个 ImportError 就够你查半小时。
