Sublime Text 不自动识别 Python 项目根目录，因其本质是文本编辑器而非 IDE，不解析 pyproject.toml 等项目文件；项目根需通过 .sublime-project 手动配置、Jedi 插件设置或 Build System 中 working_dir 拼接 $file_path 显式指定，且三者路径必须严格一致。
Sublime Text 本身不识别“项目根路径”这个概念，它只认你手动指定的 python.exe 路径和当前打开的文件；所谓“项目根”是靠你显式配置或插件推断出来的，不是自动发现的。
为什么 Sublime 不会自动识别 Python 项目根目录
Sublime Text 是文本编辑器，不是 IDE。它没有内置的 Python 项目扫描逻辑，也不会读取 pyproject.toml、setup.py 或 venv 目录来推断项目结构。当你按 Ctrl+B 运行一个 .py 文件时，它只做一件事：调用你在 Build System 里写的 cmd 数组，把 $file 当作参数传过去——工作目录就是该文件所在目录，不会向上找“项目根”。
这意味着：
- 如果你的代码里有
from mypackage import module，而mypackage在上两级目录，直接运行会报ModuleNotFoundError -
sys.path默认只含$file所在目录，不包含父目录或虚拟环境 site-packages（除非你显式加了） - 跳转到定义（Goto Definition）或补全失效，往往是因为
jedi没拿到正确的python_interpreter和sys_path
如何让 Sublime 知道你的 Python 项目根在哪
有两种主流方式，选其一即可，别混用：
立即学习“Python免费学习笔记（深入）”；
- 用
Project → Save Project As…保存一个.sublime-project文件，然后在其中手动写死"folders"和"settings"，例如：{ "folders": [ { "path": "/Users/alice/myproject" } ], "settings": { "python_interpreter": "/Users/alice/myproject/venv/bin/python", "sublime_jedi.sys_path": ["/Users/alice/myproject"] } } - 不建 project 文件，改用
Preferences → Package Settings → Jedi → Settings，在 User Settings 里填："python_interpreter": "/path/to/your/venv/bin/python", "sys_path": ["/path/to/your/project/root"]
注意：这里的python_interpreter必须和 Build System 的cmd里用的是同一个可执行文件，否则补全和跳转会错位
Build System 里怎么体现项目根路径
Build System 本身不支持变量如 $project_root，但你可以用 $file_path 做相对路径拼接，或者硬编码项目根。常见做法：
- 如果项目结构固定（比如所有源码都在
src/下），可把cmd改成："cmd": ["/path/to/venv/bin/python", "-u", "$file"], "working_dir": "$file_path/../.."
这样运行时工作目录就会上升两级，相当于项目根 - Windows 用户若路径含空格，
working_dir必须用双引号包裹，如"working_dir": "$file_path/../../"（Sublime 支持正斜杠） - 不要依赖
shell_cmd+cd组合——它会让file_regex失效，错误定位不准
容易被忽略的关键点
最常出问题的地方不在配置本身，而在一致性：
- Build System 的
cmd用的是venv/bin/python，但 Jedi 设置里填的是系统全局的/usr/bin/python3→ 补全找不到你pip install的包 - 项目根路径写成了
C:myproject，但实际路径是C:/myproject（Windows 上 Sublime 接受正斜杠，反斜杠必须双写\） - 保存了
.sublime-project却没关闭再重开窗口——Sublime 不会热重载 project 设置 - 中文路径没避让，某些插件（尤其是旧版 Jedi）会因编码问题完全失效
项目根不是个开关，是个需要三处对齐的坐标：Build System 的解释器路径、Jedi 的 python_interpreter 和 sys_path、以及你手动指定的 working_dir 或 folders。漏掉任何一处，都会导致 import 失败或跳转失灵。
