project窗口变浮动窗后,需拖至ide左边界出现蓝色吸附线时松手以恢复docked模式;若无效,先退出zen/全屏模式、取消always on top,或右键选dock pinned。

Project窗口变成浮动窗,怎么拉回左侧停靠?
WebStorm的Project工具窗口一旦被拖出边框、变成独立浮动窗,就不再响应双击分隔线缩放,也不会随编辑区自动隐藏/显示。必须手动把它“钉回”左侧 Dock 区域。
- 确保浮动窗标题栏可见(不是全屏或 Zen Mode 下)
- 用鼠标按住浮动窗左上角的标题栏,缓慢拖向屏幕最左侧边缘(不是编辑区左侧,是整个 IDE 窗口的左边界)
- 当出现垂直蓝色吸附线(或半透明 Dock 指示区)时松手,它会自动贴入左侧并恢复为 Docked 模式
- 如果拖过去没反应,说明当前处于
Float或Window模式,右键该浮动窗标题栏 → 选Dock pinned(不是Dock unpinned)
为什么拖不回去?常见卡点
拖拽失败往往不是操作问题,而是状态冲突:
- 当前处于
Distraction Free Mode或Full Screen:先按Esc或View → Exit Zen Mode退出 - 浮动窗被设为
Always on Top:右键标题栏 → 取消勾选Always on Top - 多显示器环境下,浮动窗可能卡在不可见屏幕外:Win 上按
Win + ←或Win + →把它拽回来;macOS 上用 Mission Control 查看所有窗口 - 某些插件(如
GitToolBox)会拦截拖拽事件:临时禁用插件再试一次
恢复后宽度还是不对,怎么重置?
回到 Docked 模式后,如果宽度仍异常宽或窄:
- 把鼠标移到 Project 窗口右侧分隔线上(光标变
↔) - 双击分隔线 → 自动缩放到最长文件名所需宽度
- 若双击无效,说明窗口尺寸被“锁定”:右键标题栏 →
Reset Size and Position(部分版本叫Restore Default Size) - 不要依赖
Window → Restore Default Layout:它会重置所有工具窗口位置,包括 Terminal、Database 等,影响更大
怎么防止下次又被拖成浮动窗?
根本解法是关掉自由拖拽的“惯性”:
- 进
Settings | Appearance & Behavior | System Settings - 取消勾选
Resize tool windows when dragging their borders - 同时检查
Project右上角齿轮图标 → 关闭Autoscroll to Source和Autoscroll from Source,这两个功能在跳转文件时容易意外撑开窗口
浮动窗本身不是 bug,但 WebStorm 对它的尺寸记忆和 Dock 行为非常敏感——一旦脱离 Dock,它就彻底脱离 Project 窗口的自动缩放逻辑,后续所有宽度调整都得手动干预。











