有效的.sublime-project文件必须通过Project→Save Project As…生成,先添加文件夹再保存,路径用正斜杠、UTF-8编码,含必填folders字段;settings中tab_size等支持项目级覆盖的配置才生效,JSON错误或未激活项目将静默失效。

项目专属配置不是靠改全局设置,而是靠 .sublime-project 文件生效——它一保存就管用,但写错 JSON 或路径不对,就会静默失效。
怎么生成有效的 .sublime-project 文件
别手动新建空文件,Sublime 不认;必须走菜单触发生成逻辑:
- 先通过
Project → Add Folder to Project把项目根目录加进当前窗口(或直接拖文件夹到侧边栏) - 再点
Project → Save Project As…,保存到项目根目录下,文件名建议用myapp.sublime-project这种清晰命名 - 保存后会自动生成两个文件:
myapp.sublime-project(可提交到 Git)和myapp.sublime-workspace(含光标位置、打开标签等,应加进.gitignore)
settings 字段里哪些配置真能覆盖全局
不是所有用户设置项都能在项目里重写,只有 Sublime 明确支持「project-level override」的才生效。常见有效项包括:
-
tab_size:设为2或4,前端/Python 项目可差异化 -
translate_tabs_to_spaces:true强制转空格,false保留 tab -
word_wrap:文档类项目设true,代码类通常保持false -
trim_automatic_white_space:保存时自动删行尾空格,建议开 -
color_scheme:可指定不同项目用不同主题,比如测试环境用暗色、文档用浅色
注意:font_size、theme 这类 UI 层设置不支持项目级覆盖,改了也没反应。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
为什么改完没效果?三个高频踩坑点
项目配置看似简单,但失效原因往往很隐蔽:
- JSON 格式错误:多一个逗号、少一个引号、用中文引号,Sublime 不报错但直接忽略整个
settings块——打开控制台(Ctrl+`)看有没有Invalid project settings提示 - 路径写错:
"path": "src"是相对项目根目录的路径,不是相对于.sublime-project文件的位置;如果项目根目录下没有src文件夹,这个folder就不加载 - 没激活项目:双击
.sublime-project文件打开,或用Project → Open Project…,单纯打开文件夹不算“激活项目”,此时项目设置不生效
如何验证项目配置已真正接管
最直接的办法是看右下角状态栏:
- 打开项目内任意文件,点击状态栏上的
Tab Size或Indent Using Spaces - 如果弹出菜单里对应项旁显示
Project Override,说明生效了 - 也可以在命令面板(
Ctrl+Shift+P)运行Preferences: Settings – Project,确保你正在编辑的是项目级设置面板,而不是 User 设置
项目配置优先级高于 User 设置但低于语法专用设置(比如 Python 文件右下角选了「Python」语法后,其语法专属缩进规则会压过项目设置),这点容易被忽略。

















