如何配置Sublime构建系统识别项目文件夹-sublime-PHP中文网

sublime构建系统不自动识别项目结构，需手动配置working_dir为$project_path并设置env.pythonpath="$project_path"，否则import跨目录模块会失败；未保存.sublime-project时$project_path为空，构建将无法定位项目根目录。

如何配置sublime构建系统识别项目文件夹

Sublime构建系统根本不会“识别”项目文件夹

构建系统（sublime-build）本身不读取 .sublime-project 中的 folders 或路径设置，它只关心当前激活的视图（即你正在编辑的文件）和系统环境。所谓“在项目里运行 Python”，其实是靠你手动保存了 .py 文件、设对了语法、选对了构建系统，再配合 $file 这类变量间接实现的。

常见错误现象：项目已添加 src/ 和 tests/ 两个文件夹，但按 Ctrl+B 运行 src/main.py 时却报错 No module named xxx——这不是构建系统没“识别项目”，而是 Python 解释器根本不知道该去哪找模块。

构建系统不自动添加 PYTHONPATH，也不会帮你切工作目录到项目根目录
$file 展开的是当前文件的绝对路径，不是项目根目录；想用项目路径得靠 $project_path，但它只在项目已加载且有 .sublime-project 时才有效
如果文件未保存（仍是 Untitled），$file 为空字符串，构建直接失败

让 Python 构建真正“感知项目结构”的关键配置

要让 import mypackage 在 src/main.py 里正常工作，必须显式控制 Python 的执行上下文。最可靠的方式是自定义一个带 working_dir 和环境变量的构建系统。

确保项目已保存为 .sublime-project 文件（否则 $project_path 为空）
在 Packages/User/ 下新建 Python3-Project.sublime-build，内容如下：

{
  "cmd": ["python3", "-u", "$file"],
  "file_regex": "^.*?File \"(...*?)\", line ([0-9]*)",
  "working_dir": "$project_path",
  "selector": "source.python",
  "env": {"PYTHONPATH": "$project_path"}
}

注意：working_dir 决定 os.getcwd() 返回什么，env.PYTHONPATH 才让 import 能跨目录解析。Windows 用户请把 python3 换成完整路径并加双引号，例如 "C:\Users\Me\AppData\Local\Programs\Python\Python311\python.exe"。

OpenClaw

一款AI开发辅助工具，主要用于开源的自托管AI智能体助手，曾用名Clawdbot、Moltbot，适合需要提升相关任务效率的用户。

下载

为什么改了 `folder_exclude_patterns` 对构建没任何影响

folder_exclude_patterns 只影响 Sublime 的索引行为（比如 Ctrl+P 能否跳转、侧边栏是否显示子项），它不参与构建流程，也不改变 cmd 执行时的文件系统视角。

你可能会遇到这些混淆点：

在项目设置里加了 "folder_exclude_patterns": ["node_modules"]，但构建时仍因 import 到 node_modules/.bin 下某个工具而失败——这是 Python 自己的行为，Sublime 不拦截也不干预
误以为排除了 dist/ 就能防止构建命令写入那里，其实 cmd 里写的 ["python", "build.py", "--output", "dist/"] 照常执行，跟排除配置无关
folder_exclude_patterns 写在用户设置里，会导致所有项目都跳过那些目录索引，但构建系统照样能 cd 进去或 import 里面的东西

调试构建系统是否真用了项目路径

最直接的办法是临时让构建输出当前工作目录和 $project_path 值：

新建一个 debug.py，内容为：

import os
print("PWD:", os.getcwd())
print("PROJECT_PATH:", os.environ.get("PROJECT_PATH", "NOT SET"))

在构建系统里把 cmd 改成：["python3", "-u", "$file"]
确保该文件已保存、语法设为 Python、构建系统选中你刚配的 Python3-Project
运行后看输出：PWD 应该等于你的项目根目录；若显示空或不对，说明 $project_path 没生效——大概率是没先通过 Project → Save Project As… 创建 .sublime-project

别指望构建系统自动推导项目结构。它没有“项目意识”，只有你给它的变量和路径。漏掉 $project_path 或忘了保存项目文件，后面所有基于路径的操作都会失效。