Sublime Text的Python构建系统默认在.py文件所在目录运行,working_dir未设置时即为该路径;需指定工作目录可用"$project_path"等变量或绝对路径,但须注意JSON转义、PYTHONPATH配置及重启生效。

Build System 里不填 working_dir 就默认在文件所在目录运行
Sublime Text 的 python 构建系统默认不会切换工作目录,它直接在当前打开的 .py 文件所在路径下执行命令。也就是说,os.getcwd() 返回的就是你保存该文件的文件夹路径——这点和 PyCharm 不同,PyCharm 默认把项目根目录设为工作目录。
如果你需要强制指定工作目录(比如项目结构是 src/main.py,但依赖的配置或数据文件在项目根目录),就得手动加 "working_dir" 字段:
-
"working_dir": "$project_path":适用于已有 Sublime 项目(.sublime-project文件),且想让所有构建都以项目根为工作目录 -
"working_dir": "$file_path":等价于默认行为,显式写出来没坏处,但没必要 -
"working_dir": "/absolute/path/to/your/project":硬编码绝对路径,适合单项目固定场景,但换机器就失效 - 别用
$folder或$packages这类未定义变量,Sublime 不识别,会导致构建失败
为什么 sys.path 和工作目录不是一回事?
很多人以为改了 working_dir 就能解决 ImportError: No module named xxx,其实不是。Python 模块导入靠的是 sys.path,而 working_dir 只影响 open()、os.chdir()、相对路径读写等行为。
要让 import 正常,得配 PYTHONPATH 环境变量,或者在 Build System 里用 "env": {"PYTHONPATH": "/path/to/your/modules"}。注意:PYTHONPATH 是路径列表,多个路径用 :(macOS/Linux)或 ;(Windows)分隔。
立即学习“Python免费学习笔记(深入)”;
- 如果用了虚拟环境,
PYTHONPATH一般不用额外设,除非你有自定义包目录 - 若同时设了
working_dir和PYTHONPATH,两者互不影响,各管各的 - 别把
PYTHONPATH指向虚拟环境的site-packages—— pip 安装的包已经自动在里面了
项目级设置比全局 Build System 更灵活
如果你的项目结构复杂(比如多层嵌套、多个入口文件、不同子模块需要不同工作目录),硬编码在 .sublime-build 里会很快失控。这时应该用 Sublime 的项目功能:
- 菜单 Project → Save Project As… 保存一个
.sublime-project文件 - 编辑该文件,在
settings下加"working_dir": "$project_path" - 再在
build_systems里引用你已有的.sublime-build,并加"target": "exec"(避免被覆盖) - 这样每个项目可独立控制工作目录,且不污染全局配置
注意:$project_path 只在项目文件存在时有效;没开项目时,这个变量为空,working_dir 会退化成当前文件目录。
容易被忽略的 Windows 路径斜杠问题
在 Windows 上写绝对路径时,别用反斜杠 直接写进 JSON(比如 "C:myproject"),JSON 会把它当成转义字符,导致路径解析失败或报错 Invalid escape character。
- 正确写法是双反斜杠:
"C:\my\project" - 或统一用正斜杠:
"C:/my/project"(Sublime 和 Python 都支持) - 最稳妥的是用
$project_path或$file_path这类内置变量,完全避开手动写路径 - 如果路径含空格或中文,JSON 本身没问题,但某些旧版 Python 启动器可能出错,建议路径全英文、无空格
真正麻烦的从来不是怎么写路径,而是改完之后忘了重启 Sublime 或没选对 Build System —— Ctrl+Shift+P 输入 “Build System: Select” 再确认一遍当前激活的是你刚改的那个,否则所有配置都是白搭。


















