Ctrl+Alt+Z（Windows/Linux）或Cmd+Alt+Z（macOS）可临时开关当前文件软换行，仅作用于当前编辑器标签页，不改变设置；需确保文件类型正确、未处于全屏模式且无插件冲突。
怎么用快捷键临时开关当前文件的 Soft Wrap
PhpStorm 没有全局“一键切换所有文件软换行”的快捷键，但对当前打开的文件，确实存在一个即时生效的快捷键：Ctrl+Alt+Z（Windows/Linux）或 Cmd+Alt+Z（macOS）。它只作用于当前编辑器标签页，不改变设置里的默认行为，也不影响其他已打开或新打开的文件。
这个快捷键本质是触发「Toggle soft wrap」动作，和右键菜单里点 Soft-Wrap 效果完全一样。适合临时查看某段超长 SQL、JSON 或 base64 字符串时快速启用，看完再按一次关掉——避免干扰其他文件的阅读节奏。
- 必须聚焦在编辑器内容区（不能在侧边栏、终端或设置窗口里按）
- 如果按了没反应，先检查是否被输入法或系统级快捷键拦截（尤其 macOS 上
Cmd+Alt+Z可能和某些截图工具冲突） - 该快捷键不会保存状态，关闭再重开文件，会回到该文件类型在
Soft wraps in files with extensions中的预设值
为什么 Ctrl+Alt+Z 有时失灵？三个常见卡点
不是快捷键坏了，而是它被更高优先级的状态覆盖或阻断：
- 当前文件被识别为错误类型：右下角状态栏显示的是
Text或Plain Text而非PHP/JavaScript，Ctrl+Alt+Z就不会生效——右键标签页 →Override File Type改回正确类型即可 - 处于全屏编辑模式（
F11或Ctrl+Shift+F12），软换行功能被强制禁用，快捷键自然无效；退出全屏后立即恢复 - 插件劫持渲染层：
String Manipulation插件在 v4.5.0 之前版本、或某些未更新的Key Promoter X版本会拦截编辑器重绘逻辑，导致软换行开关失效；临时禁用这两个插件可验证
Soft Wrap 和 Right Margin 的关系别搞混
有人以为开了 Right margin（比如设成 120 列）就能让代码“自动换行”，这是典型误解。这两者完全独立：
立即学习“PHP免费学习笔记（深入）”；
-
Soft wrap是纯视觉折行，只改你眼睛看到的样子，不影响源码、Git 提交、运行时输出 -
Right margin是格式化依据，只在你按Ctrl+Alt+L时起作用，决定数组、函数参数等结构如何被拆成多行 - 即使勾了
Wrap when typing reaches right margin，打字到第 120 列也不会自动插入\n，除非你同时开了Soft wrap才能在界面上“看见”那个换行提示线
想让新打开的 .php/.js 文件默认软换行？光按快捷键不够
Ctrl+Alt+Z 解决不了“每次打开新文件都要手动开”的问题。真正起效的是设置白名单：
- 进
Settings → Editor → General → Soft Wraps - 勾选
Use soft wraps in editor（总开关） - 在
Soft wraps in files with extensions输入框填入：php,js,ts,html,css,md（逗号分隔，**不要空格**） - 填完立刻生效：新打开的匹配后缀文件自动启用软换行，不用再按快捷键
注意：已打开的文件仍需手动按 Ctrl+Alt+Z 或右键开启，这是 PhpStorm 的设计逻辑，不是 bug。
