sublime便携版启动后仍写入%appdata%说明便携模式未生效，根本原因是data文件夹位置或命名错误：必须与sublime_text.exe同级、严格命名为data、首次运行前已存在，否则fallback至系统路径。
Sublime便携版启动后仍写入%APPDATA%
这说明便携模式根本没生效，不是“启动失败”，而是“启动成功但走错路”。核心原因只有一个：Data 文件夹位置或命名错误。
-
Data必须与sublime_text.exe在同一级目录（不能是bin/Data或app/Data） - 名称必须严格为
Data：首字母大写，其余小写；data、DATA、MyData全部无效 - 首次运行前就要存在该文件夹；如果已误启动过，得先删掉
%APPDATA%\Sublime Text（Windows）或~/Library/Application Support/Sublime Text（macOS）再重试 - 验证方式：菜单 → Preferences → Browse Packages…，路径必须显示为你的U盘路径 +
Data\Packages，否则就是失败
直接双击 sublime_text.exe 启动导致便携失效
官网 ZIP 包默认不启用便携逻辑，尤其在旧系统或企业镜像环境下，Data 自动识别机制可能被忽略，直接 fallback 到系统路径。
- 最稳做法是用
--data参数强制指定：例如sublime_text.exe --data "Data" - 务必用批处理脚本（如
start.bat）封装启动命令，且脚本与sublime_text.exe同级 - 不要依赖快捷方式——目标字段对含空格/中文的路径支持极差，容易截断参数
- 首次运行后检查
Data\Packages\User\Preferences.sublime-settings是否生成，这是便携配置落地的铁证
Package Control 安装失败引发的“假性无法启动”
看起来能打开界面，但插件管理器不加载、命令面板搜不到 Package Control: Install Package，用户常误以为“启动异常”，其实是环境没切进便携通道。
- 控制台执行安装脚本前，必须确认
Data已生效，否则sublime.installed_packages_path()返回的是系统路径，插件会被装到%APPDATA%里 - 必须用 Python 3.3+ 新版脚本（含
urllib.request和 SHA256 校验），老版urllib2脚本已彻底失效 - 若提示
Error validating download，不是脚本问题，而是代理/防火墙篡改了下载内容；此时应手动下载Package Control.sublime-package，放入Data\Installed Packages\（该目录需手动创建）再重启
便携版 License 激活失败导致反复弹窗干扰使用
不是启动不了，而是每次打开都弹 Please purchase a license，让人误以为崩溃或卡死。本质是便携版和安装版 license 不互通，且便携版不走 UI 激活流程。
- 便携版的许可证必须以文件形式存放：把密钥全文（含
----- BEGIN LICENSE -----和----- END LICENSE -----）保存为纯文本，命名为license.sublime_license，放进Data\Packages\User\ - 不能通过 Help → Enter License 粘贴——便携版的这个菜单项实际不读取输入，只起占位作用
- 若之前在安装版里输过无效密钥，残留的
Local目录会干扰便携版行为，建议彻底清理系统侧数据目录后再部署便携版
真正卡住启动的极少，绝大多数所谓“无法启动”，都是配置落点错位、路径未生效、或插件/授权逻辑没对齐便携路径。盯住 Data 是否被识别，其他问题基本都能顺藤摸瓜。
