sublime如何设置项目专属配置文件？（不同项目不同规则）

sublime Text 项目配置需在根目录放名为 .sublime-project 的合法 jsON 文件，通过 “settings” 和 “folders” 实现项目级与子目录级规则覆盖，且必须通过 Project → Open Project 加载才生效。

项目根目录下放 .sublime-project 文件

sublime text 不通过全局设置实现“不同项目不同规则”，而是靠每个项目专属的 .sublime-project 文件。这个文件必须放在项目根目录（即你用 Project → Open Project 打开的那个文件夹），且必须是合法 json 格式。

常见错误：把配置写在 Preferences.sublime-settings 里，或放在子目录、重命名成 sublime-project.json —— 这两种都不会生效。

• 文件名必须严格为 .sublime-project（开头带点，无后缀）
• 内容需是 JSON 对象，最外层不能是数组或纯字符串
• 如果项目已打开，修改后需执行 Project → Save Project As… 才会写入磁盘（仅新建项目时自动创建）

"settings" 块控制编辑器行为，"folders" 定义作用范围

项目配置的核心是 "settings" 字段，它会覆盖用户/语言级设置，只对当前项目生效。而 "folders" 不只是路径列表，它还能为不同子目录指定独立规则（比如排除某些文件、启用特定构建系统）。

例如，你想让 backend/ 下的 python 文件默认使用 4 空格缩进，但 frontend/ 下的 JS 用 2 空格，不能靠一个 "tab_size" 统一设 —— 得配合文件夹作用域和语法绑定。

• "settings" 里的键（如 "tab_size"、"trim_trailing_white_space_on_save"）直接生效于整个项目
• "folders" 中每个对象可加 "path" 和 "settings"，后者仅对该路径下的文件起作用（需 Sublime Text 4126+）
• 若需按语法区分规则（如 JS vs Python），应在 "settings" 外层用 "syntax_specific_settings"，但该字段不支持写在项目文件中，只能靠语言包自带或用户级配置

{   "folders":   [     {       "path": "backend",       "settings": {         "tab_size": 4,         "translate_tabs_to_spaces": true       }     },     {       "path": "frontend",       "settings": {         "tab_size": 2,         "detect_indentation": false       }     }   ],   "settings": {     "font_size": 13,     "ignored_packages": ["Vintage"]   } }

文件编码、换行符、自动补全等细节也走 "settings"

很多人只改缩进或字体，却忽略 "default_encoding" 或 "default_line_ending" 导致协作时出问题。这些字段在项目配置中优先级高于用户设置，适合强制统一团队规范。

另外，"auto_complete"、"auto_complete_commit_on_tab" 这类补全行为，以及 "index_files"（是否索引项目内文件用于 goto Definition），都可在项目级开关 —— 尤其适合大型单体仓库，避免为整个工作区建索引拖慢响应。

• "default_line_ending" 推荐设为 "unix"（即使 windows 用户），防止 git 提交时误转 CRLF
• "index_files" 设为 false 可显著降低内存占用，但会禁用项目内符号跳转
• "binary_file_patterns" 支持正则，比如 "node_modules/**" 或 "*.log"，避免大日志文件被加载进缓存

项目配置不会继承用户设置，记得手动补全常用项

Sublime Text 的配置层级是「项目 > 语法 > 用户 > 默认」，项目配置是完全覆盖，不是叠加。这意味着如果你只写了 "tab_size"，那 "font_face"、"highlight_line" 这些用户级设置就失效了 —— 编辑器会回退到默认值（通常是 Courier、无高亮）。

所以实际使用中，建议从用户设置里复制一份基础配置，再在项目文件中增量修改。否则容易出现字体变小、括号不匹配、行号消失等“突然变陌生”的情况。

• 不要假设项目配置会保留你习惯的 ui 行为，所有视觉和交互相关项都要显式声明
• 用 Preferences → Settings – User 查看当前用户设置，挑关键项粘贴进项目文件的顶层 "settings"
• 如果项目含多种语言，且某语言需要特殊插件行为（如 ESLint 配置路径），得额外配 "build_systems" 或插件专属字段（如 "eslint_options"），这类字段不在 Sublime 原生文档里，得查对应插件说明

项目配置真正生效的前提，是你始终用 Project → Open Project 打开那个 .sublime-project 文件，而不是直接打开文件夹或单个文件 —— 后两者根本不会加载项目配置。