Sublime Text 的 File → Open Folder… 默认新建窗口是预期行为，非 bug；避免新开窗口应改用 Project → Add Folder to Project…，且需确保无 .sublime-project 文件加载。
用 File → Open Folder… 会开新窗口？这是预期行为
Sublime Text（包括便携版）的 File → Open Folder… 命令默认策略就是「新建窗口」，和是否便携无关，也和 "open_files_in_new_window" 配置项无关——这个配置只对文件生效，对文件夹完全不监听。
你看到新窗口弹出，不是 bug，是 Sublime 底层设计如此。想避免新开窗口，就得绕过这个命令。
- 别用
File → Open Folder…，改用Project → Add Folder to Project… - 确保当前窗口没加载任何
.sublime-project文件（标题栏不显示项目名），否则该菜单项可能灰掉 - 选中目标文件夹后，它会立刻出现在侧边栏，且已打开的标签页全部保留
- 如果菜单项不可点，先按
Ctrl+Shift+P输入Project: Edit Project，删掉当前项目配置再试
便携版下拖拽文件夹进窗口 ≠ 加载项目
很多人把整个项目文件夹拖进便携版窗口，结果只是打开了该目录下所有可读文件（比如 .py、.js），侧边栏仍是空的，Ctrl+P 搜不到子目录里的文件——这不是便携版限制，是 Sublime 所有版本共有的行为：拖拽文件夹仅触发 open_file 批量调用，不建立项目上下文。
- 拖进去之后检查侧边栏：如果没出现目录树，说明没加载成项目
- 拖完立刻按
Ctrl+P搜一个子目录下的文件，搜不到就确认失败 - 正确做法：拖完后马上执行
Project → Add Folder to Project…，选同一路径补救 - 便携版无额外限制，但需确认
Packages/User/路径可写（某些 U 盘 FAT32 格式不支持隐藏文件，会导致项目缓存失败）
project_open_folder 快捷键在便携版里静默失败？先看状态栏
project_open_folder 是 Sublime Text 4.5+ 的原生命令，便携版只要版本够新就能用，但它有个硬性前提：当前窗口必须已通过 Project → Add Folder to Project… 或 File → Open Folder… 加载过项目，且状态栏右下角显示类似 ~/my-project/ 的路径。否则命令不报错，也不执行，纯静默。
- 按快捷键前，先盯一眼状态栏最右侧有没有路径显示
- 没有？说明项目未被识别，
project_open_folder不会工作 - 有路径但点开是空的？检查该路径是否存在、是否被
folder_exclude_patterns排除（比如写了"node_modules"却漏了斜杠） - macOS 下快捷键必须用
cmd+shift+o，Windows 用ctrl+shift+o，别硬套
为什么 open_file_folder 按下没反应？先查 view.file_name()
open_file_folder 命令作用于当前编辑视图，但它要求该视图必须已保存且路径有效。便携版常见失效场景是：你刚新建一个 untitled 标签页，或打开了一个网络路径、WSL2 挂载路径（如 /mnt/c/Users/…），或文件在只读分区。
- 按
Ctrl+`打开控制台，输入view.file_name()，返回None就说明当前没路径 - 返回路径但打不开？可能是系统权限问题（尤其 Windows 上 WSL2 路径在原生 Sublime 中常被拒绝）
- 别在 User Key Bindings 里加
"args": {"file": "$file_path"}—— 这是冗余的，Sublime 会报KeyError: 'file' - 验证命令是否可用：按
Ctrl+Shift+P输入Open Containing Folder，能点开就说明命令本身没问题
便携版和安装版在项目加载逻辑上完全一致，真正卡住人的从来不是“便携”二字，而是 Sublime 对“项目”的定义比直觉更严格：它不靠文件夹存在判定，而靠你是否显式执行过项目级操作。状态栏没路径，project_open_folder 就不会动；当前视图没真实路径，open_file_folder 就静音——这两点最容易被忽略。
