便携版Sublime Text离线运行Ruby的核心是正确创建Data目录并配置绝对路径的Build System：Data必须与可执行文件同级、首字母大写、首次启动前存在；Ruby需用绝对路径调用，不可依赖环境变量或shell配置。
Sublime Text 要实现便携版 + Ruby 离线运行，核心不是“装插件”或“改设置”，而是两件事：确保 Data 目录被正确识别，以及让 ruby 命令在无网络、无系统环境变量的环境下仍能调用。其他都是枝节。
便携模式失效的唯一硬指标：Preferences → Browse Packages… 不指向 Data
这是所有问题的起点。只要菜单里打开的路径不是你软件根目录下的 Data/Packages，后面所有配置都白做——插件会装进 %APPDATA% 或 ~/Library/...，Ruby 构建系统也只会写到错误位置。
-
Data文件夹必须与sublime_text.exe（Windows）或sublime_text（macOS/Linux）在同一级目录，不能嵌套在子文件夹里 - 名称必须严格为
Data（首字母大写，其余小写），data、DATA、MyData全部无效 - 首次运行前就要存在；如果已误启动过，先删掉系统默认配置目录再重试（Windows：
%APPDATA%Sublime Text；macOS：~/Library/Application Support/Sublime Text） - FAT32 格式的 U 盘不支持符号链接和部分权限，
Data目录下某些插件缓存可能写失败，建议用 exFAT 或 NTFS
离线运行 Ruby 的关键：Build System 不能依赖 shell 环境变量
GUI 启动的 Sublime 不读 ~/.zshrc 或系统 PATH，所以即使终端里 ruby --version 正常，Ctrl+B 也会报 command not found: ruby。离线场景下，更不能指望 zsh -l -c 去加载远程配置或触发网络代理。
- Windows 用户必须用绝对路径：
"cmd": ["C:\Ruby32-x64\bin\ruby.exe", "$file"]—— 注意双反斜杠，且路径不能含空格（C:\Program Files会静默失败） - macOS/Linux 用户若用 rbenv，别写
~/.rbenv/shims/ruby（~不解析），改用绝对路径如/Users/yourname/.rbenv/shims/ruby - 不推荐
"shell_cmd": "zsh -l -c 'ruby $file'"离线使用：万一~/.zshrc里有 curl 或 git 拉取操作，会卡住或失败 - 验证是否生效：按
Ctrl+`打开控制台，输入import os; print(os.environ.get('PATH'))，输出里不需要出现 ruby 路径——因为构建系统已绕过它
语法高亮和错误定位必须手动绑定，离线时插件不会自动补救
便携版首次打开 .rb 文件，右下角显示 Plain Text 是正常现象。这不是插件没装好，是 Sublime 原生机制：它不会自动把扩展名和语法关联，尤其离线时 Package Control 无法拉取语言定义包。
- 打开任意
.rb文件 → 点右下角Plain Text→ 选Ruby→ 点右侧弹出的Open all with current extension as… - 构建报错后双击跳不到行号？大概率是
file_regex不匹配 Ruby 实际输出格式。用这个最稳："file_regex": "^([^:]*?):([0-9]+):(?:[0-9]+)?:?.*" - 如果项目用非标扩展名（如
.ru、.rake），也要单独执行一遍Open all with current extension as…，否则高亮和构建都无效
Package Control 和插件必须提前准备好，离线时无法动态安装
离线 ≠ 不能用插件，但必须把插件二进制包（.sublime-package）和配置文件提前放进 Data 目录对应位置。否则 Ctrl+Shift+P 里连 Package Control: Install Package 都不会出现。
- 提前下载
Package Control.sublime-package，放进Data/Installed Packages/，重启生效 - 插件本身：从另一台已装好插件的机器上复制整个
Data/Installed Packages/和Data/Packages/User/到便携版对应位置 - 如果用
RuboCop类工具，需提前在目标机器上运行gem install rubocop，并确认rubocop命令可执行（离线时 SublimeLinter 不会帮你装 gem） - 不要依赖
channel_v3.json离线源：它只对插件市场有效，不影响 Ruby 解释器调用
真正麻烦的从来不是配置步骤，而是 Data 目录的位置、大小写、创建时机这三个点——90% 的“便携失败”卡在这里。Ruby 运行只是个命令路径问题，而便携性是整个数据生命周期的起点。一旦 Browse Packages… 显示的是你 U 盘上的路径，剩下的就只是填对 JSON 字段而已。
