只打包 packages/user/ 目录即可复现编辑体验；需保留 preferences.sublime-settings、package control.sublime-settings、平台快捷键、插件用户配置及 .sublime-snippet，排除 session.sublime_session、local/、缓存和索引文件，并依赖 package control 自动重装插件。
只打包 Packages/User/ 目录，其他全删掉
团队成员拿到配置后能立刻复现你的编辑体验，前提是只打包 Packages/User/ 下的真实配置文件。整个 Packages/ 目录不能打——里面混着插件源码（如 Emmet/）、缓存（Package Control.cache）、会话状态（Session.sublime_session），这些一同步过去，对方打开 Sublime 就可能报 ImportError: No module named 'package_control' 或插件菜单直接变灰。
真正该打包的只有这几类：
-
Preferences.sublime-settings：字体、缩进、主题等全局行为 -
Package Control.sublime-settings：含installed_packages列表，决定装哪些插件 - 平台专属快捷键：
Default (Windows).sublime-keymap、Default (OSX).sublime-keymap等 - 各插件用户配置：
SideBarEnhancements.sublime-settings、SublimeCodeIntel.sublime-settings - 自定义代码片段：
*.sublime-snippet
打包前建议用 Preferences → Browse Packages… 确认路径，ST4 用户注意把路径里的 3 换成 4；Linux/macOS 路径含空格或特殊字符时，压缩工具要支持 UTF-8 编码，否则 .sublime-snippet 文件可能 XML 解析失败。
别碰 .sublime-project 文件，除非你真想共享项目级行为
团队协作不是靠同步个人设置，而是靠把配置“沉到项目里”。如果你把 myproject.sublime-project 打包进去并让成员直接覆盖他们的 User/，反而会破坏他们本地的全局偏好（比如他们习惯 4 空格缩进，而你的项目设了 "tab_size": 2）。
正确做法是：把 .sublime-project 放进项目根目录，和 .editorconfig、.prettierrc.yml 一起提交 Git。这样只有当成员用 File → Open Project… 打开这个项目时，里面的 "folders"、"settings" 和插件专属参数（如 "SublimeCodeIntel" 块）才会生效，且不干扰其他项目。
常见错误：
- 把
.sublime-project放进User/目录 —— Sublime 不识别，完全不加载 - 在
.sublime-project里写死本地绝对路径（如"path": "C:/dev/myproj"）—— 其他人拉下来就索引失败 - 漏配
"folder_exclude_patterns"—— 导致node_modules被全文搜索拖慢响应
给成员的部署脚本要跳过运行时文件
你发一个 setup_sublime.sh 或 setup_sublime.bat 给团队，核心逻辑必须是“解压 → 覆盖 → 清理”，而不是无脑复制。尤其要过滤掉这些不该出现的文件：
-
Session.sublime_session：含本地打开的标签页、光标位置，同步后对方一启动就丢上下文 -
Local/目录：存临时缓存、未保存草稿，不同设备内容必然冲突 -
*.cache、Package Control.cache：版本/平台不一致时直接导致插件初始化失败 -
Index Files/：Sublime 自建的符号索引，跨机器无效且体积大
示例（macOS/Linux）：
unzip sublime-config.zip -d /tmp/sublime-user rsync -av --delete --exclude='Session.sublime_session' --exclude='Local/' --exclude='*.cache' /tmp/sublime-user/User/ "$HOME/Library/Application Support/Sublime Text 4/Packages/User/"
Windows 同理，用 robocopy 时加 /XF Session.sublime_session *.cache 和 /XD Local。
插件不能靠打包同步，得靠 Package Control.sublime-settings 驱动重装
你打包的 Packages/User/ 里只有 Package Control.sublime-settings，没有插件本体（Emmet/、GitGutter/ 等）。这是对的——插件二进制或 Python 源码本身有平台依赖，Windows 的 .sublime-package 在 macOS 上大概率无法加载。
成员收到配置后，只需重启 Sublime，Package Control 会自动读取 installed_packages 列表并下载对应插件。但要注意：
- 确保对方已安装 Package Control（没装就先跑官网命令）
- 如果列表里有已弃用插件（如老版
Sync Settings），得手动删掉对应项，否则控制台持续报错 - 某些插件（如
Terminus）需额外依赖系统命令（python、git），得提醒成员提前装好
最后检查点：让成员打开 Ctrl+Shift+P 输入 Package Control: List Packages，确认列表和你的一致——这才是真正生效的标志，而不是看 Packages/ 目录里有没有那个文件夹。
