Sublime Text团队配置共享不能同步User目录，而应将项目专属设置（如Python解释器路径、linter参数、索引范围）沉入.sublime-project文件并提交Git；必须通过Project → Open Project…加载才生效，且需配合.editorconfig等文件统一格式规则。
Sublime Text 的配置同步不能靠“复制 User 目录”或“插件自动上传”来实现团队共享，因为团队协作和跨设备个人同步是两类问题：前者要隔离项目上下文，后者要统一用户习惯。强行混用会导致 SublimeLinter 找不到项目级 flake8、SublimeCodeIntel 索引错路径、甚至格式化命令在 A 项目生效而在 B 项目报 command not found。
为什么不能把 User 配置当团队配置发给所有人
团队成员的系统环境（Python 版本、shell 路径、SSH 配置）、本地开发目录结构、甚至终端编码都不同。Preferences.sublime-settings 里写死 "font_size": 14 没问题，但写 "python_interpreter": "/home/alex/.pyenv/versions/3.11.9/bin/python" 就会让其他成员的 SublimeCodeIntel 直接失效。更关键的是，Package Control.sublime-settings 中的 installed_packages 列表一旦同步，会强制所有人装一模一样的插件——而有些插件（如 SideBarEnhancements）在 Windows 和 macOS 下行为不一致，有些（如 GitSavvy）依赖本地 git 命令路径。
-
Preferences.sublime-settings只应保留纯 UI 类设置：主题、字体、缩进、行距 - 所有带路径、命令、解释器、环境变量的配置，必须下沉到项目层
-
Default (Windows).sublime-keymap等快捷键文件若含平台特有逻辑（如调用cmd.exe），就不该进团队仓库
.sublime-project 是团队配置落地的唯一可靠位置
团队真正需要共享的，是每个项目独有的行为逻辑：用哪个 Python 解释器、是否启用 eslint、prettier 配置从哪读、哪些目录该被索引、构建命令怎么跑。这些必须通过 .sublime-project 文件声明，并提交进 Git 仓库。
- 在项目根目录新建
myapp.sublime-project，内容只包含"folders"、"settings"、"build_systems"和插件专属块（如"SublimeLinter"） -
"folders"必须用相对路径："path": "."，禁用绝对路径；排除"folder_exclude_patterns"如["venv", "dist", "node_modules"] - 语言相关设置（如
"tab_size"）优先写在.editorconfig或.prettierrc.yml，让EditorConfig和Prettier插件自动加载，避免重复维护 - 插件参数必须显式声明作用域，例如：
"SublimeLinter": { "lint_mode": "save", "paths": { "linux": ["./node_modules/.bin"], "osx": ["./node_modules/.bin"] } }
团队成员如何正确加载项目配置
Sublime Text 不会自动识别并加载项目根目录下的 .sublime-project 文件——你必须通过它打开项目，否则所有项目级配置都不生效。这是最容易被忽略的执行细节。
- 禁止双击文件夹打开项目；必须用
File → Open Folder…或命令行subl .（确保当前路径是项目根目录） - 检查是否加载成功：打开任意文件后按
Ctrl+Shift+P→ 输入Project: Edit Project，能正常打开编辑即表示已激活 - 如果
SublimeCodeIntel仍索引错误目录，确认.sublime-project中"SublimeCodeIntel"块里的"scan_files_in_project"为true，且"max_recursive_dir_depth"足够深 - 团队应约定 README.md 中注明：“请始终使用
subl .启动本项目”
真正的团队配置共享，不是把某个人的 User 目录发给所有人，而是把每个项目的上下文约束（路径、命令、规则）沉到 .sublime-project + .editorconfig + 插件配置文件中，并通过 Git 管控。谁改了 .sublime-project，就等于改了整个团队在这个项目里的编辑行为——这个责任边界，比同步快捷键重要得多。
