sublime text免安装版需用官网zip包+--data参数指定data文件夹,双击exe无效,须用.bat脚本启动;data必须同级、首字母大写;package control需控制台脚本安装。

sublime_text.exe 本身不是免安装版——它只是可执行文件;真正“免安装”取决于你**怎么启动它、数据往哪写**。官网 ZIP 包解压后直接双击 sublime_text.exe,默认仍会往 %APPDATA%\Sublime Text 写配置,U盘一拔就丢设置。所谓“免安装”,本质是用 --data 参数接管所有用户路径。
必须从官网下载 ZIP 包,别碰 .exe 安装器
官网 sublimetext.com 提供两种分发形式:sublime_text_build_4162_x64.zip(ZIP)和 sublime_text_setup.exe(安装器)。后者会写注册表、注入右键菜单、强制把配置存到 %APPDATA%,根本不是便携版。
ZIP 包解压后只有 sublime_text.exe 和几个 DLL,体积小、无副作用,但需要你手动控制数据落盘位置。验证方式很简单:解压后目录里没有 Data 文件夹、也没有 Uninstall.exe 或 sublime_text.msi ——有就是假便携。
- Windows 下确认 ZIP 包名含
Build xxxxx x64.zip,不含setup或installer - macOS/Linux 用户注意:官网 tar.xz 包也支持
--data,但需配合SUBLIME_DATA_PATH环境变量才可靠 - 别信第三方打包的“绿色版”,它们常偷偷调用系统缓存或硬编码路径,跨电脑失效率极高
启动前必须建好同级 Data 文件夹
解压 ZIP 后,sublime_text.exe 所在目录下**必须手动新建一个空文件夹,名字严格为 Data(首字母大写,其余小写)**。不是 data、不是 DATA、不能带空格或下划线。
这个 Data 文件夹是便携的核心锚点:首次启动时,sublime_text.exe 会自动在其中生成 Packages/、Installed Packages/、Local/ 等子目录。所有插件、用户设置、缓存、会话状态都落在里面。
- 常见错误:先双击
sublime_text.exe再建Data→ 已写入%APPDATA%,得手动删掉%APPDATA%\Sublime Text并重启 - 常见错误:把
Data建在子目录里(如bin/Data)→ Sublime 不识别,照样走系统路径 - 验证是否生效:菜单 → Preferences → Browse Packages…,路径必须显示为
D:\xxx\Data\Packages,否则说明Data位置或命名错了
Windows 下双击启动必须用 .bat 脚本,不能靠快捷方式
直接双击 sublime_text.exe 会忽略 --data 参数,强行读取系统路径。这不是 Bug,是官方设计行为——默认优先兼容安装版逻辑。
快捷方式目标字段传参极不可靠:路径含中文或空格时参数常被截断;不同 Windows 版本对引号解析不一致;目标长度超限会被静默截断。唯一稳定做法是写一个 launch.bat 脚本:
start "" "sublime_text.exe" --data "%~dp0Data"
把脚本放在和 sublime_text.exe 同级目录,双击它即可。其中 %~dp0 是批处理变量,自动解析当前目录路径,避免硬编码出错。
- 别用“发送到桌面快捷方式”——它本质还是快捷方式,同样不稳定
- 如果路径含中文或空格,
--data后的值必须用英文双引号包裹,如--data "D:\我的工具\Sublime\Data" - macOS/Linux 用户等价命令是:
export SUBLIME_DATA_PATH=./Data && ./sublime_text --new-instance
Package Control 必须手动安装,且脚本要适配 ST4+
便携版首次启动后,Ctrl+Shift+P 搜不到 Package Control: Install Package——这是正常现象。旧版网上流传的 import urllib2 脚本已全面失效,ST4.4.5+ 默认用 Python 3.8+,且 packagecontrol.io 域名和校验逻辑已更新。
正确做法是:按 Ctrl+` 打开控制台,粘贴执行以下代码(注意复制完整,末尾换行不能漏):
import urllib.request,os,hashlib; h ='df21e130d211cfc94d9b0905775a7c0f1e3d39e33b79698005270310898eea76'; pf ='Package Control.sublime-package'; ipp = sublime.installed_packages_path(); by = urllib.request.urlopen('http://packagecontrol.io/'+ pf.replace(' ','%20')).read(); dh = hashlib.sha256(by).hexdigest();print('Error validating download (got %s instead of %s)'% (dh, h))ifdh != helseopen(os.path.join(ipp, pf),'wb').write(by)
- 执行后若打印
Error validating download,说明网络中间有代理或缓存污染,应手动下载Package Control.sublime-package放进Data\Installed Packages\,再重启 - 成功后重启 Sublime,
Ctrl+Shift+P就能搜到Package Control: Install Package,所有插件都会落在Data\Installed Packages\和Data\Packages\里 - 别用命令面板里搜
Install Package Control—— 这个入口在 ST4.4.5+ 中已被移除,只保留控制台脚本方式
Data 存在、命名精确、路径同级,并且启动方式绕过系统路径劫持。这些细节漏掉任何一环,U盘换电脑后插上就变回空白编辑器。











