folders字段写错会导致整个项目静默失效,必须为顶层必填项、每个folder含合法path字符串、路径真实存在且不含中文或空格,修改后需手动重载项目才生效。

folders 字段写错,整个项目就静默失效
Sublime Text 不会报错、不提示、不加载任何文件夹,只要 folders 字段缺失、为空数组 []、路径用了反斜杠 \,或者拼写错误(比如 "path": "srce"),它就直接跳过这个 .sublime-project 文件。侧边栏空白 ≠ 项目加载失败,这是最易被忽略的假象。
必须满足三个硬性条件:
-
folders是顶层必填字段,不能嵌套在其他对象里 - 每个
folder对象必须含"path",且值为字符串(如"."或"src"),Windows 下也得用正斜杠/ - 路径必须真实存在,且不能含中文、空格或特殊符号(
我的项目.sublime-project会静默失败)
验证方式:保存后立刻按 Ctrl+Alt+P(Win/Linux)或 Cmd+Alt+P(Mac),输入 “Reload Project” 执行;若底部状态栏没提示 Invalid project file,不代表有效——要检查窗口标题栏是否显示了项目名(如 myapp — Sublime Text)。
settings 修改后不会自动生效,必须重载项目
你在 .sublime-project 的 settings 里改了 tab_size、spell_check、word_wrap,这些设置不会随文件保存而应用。Sublime 不监听 JSON 变更,也不热更新。
生效唯一路径是手动重载:
- 菜单:Project → Reload Project
- 快捷键:
Ctrl+Alt+P/Cmd+Alt+P,再搜 “Reload” - 重载后仍无效?检查
settings是否在顶层(和folders并列),不是缩进错位、没加逗号,也没被包进folders[0]里
color_scheme 和 theme 在 .sublime-project 中会被完全忽略,控制台会输出 Ignoring invalid project setting: color_scheme——这不是 bug,是设计如此。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
多文件夹项目不能靠“打开根目录”,得用 Add Folder to Project
想把 frontend/ 和 backend/ 同时纳入一个项目?别只打开父目录。Sublime 的 folders 不支持通配符或递归扫描,必须显式声明每个路径。
正确流程:
- 先用
File → Open Folder…打开其中一个(如frontend/) - 再用
Project → Add Folder to Project添加backend/ - 最后必须执行
Project → Save Project(注意不是Save Project As…),否则重启即丢失
每个 folder 可独立设 folder_exclude_patterns(如 ["node_modules"])和 file_exclude_patterns(如 ["*.log"]),但注意:排除模式大小写敏感,写成 ["Node_modules"] 不会匹配 node_modules。
build_systems 和插件设置是否起作用,取决于它们读不读 view.settings()
build_systems 字段能定义项目专属构建命令(比如 Python 脚本用不同解释器),但它只是注册,是否被调用由构建系统本身决定。而插件是否响应项目级配置,要看插件源码有没有调用 view.settings().get("xxx")。
快速验证方法:
- 在
.sublime-project的settings里加个测试字段:"my_test": true - 打开任意项目内文件,在 Sublime 控制台(
Ctrl+`)运行:sublime.active_window().active_view().settings().get("my_test") - 返回
True表示项目设置已加载且插件可读取;返回None则要么没重载,要么字段位置错了
所有自定义变量(如 ${project_path}、${folder})只在 build_systems 和部分插件中生效,folders.path 里不支持变量展开——这点容易踩坑。










