PhpStorm 的“自动换行”实为软换行（soft wrap），需开启总开关并配置扩展名白名单（如php,js,ts等）才对指定文件生效；它仅影响编辑器视觉显示，不改变代码结构或运行时行为。
PhpStorm 的“自动换行”不是代码格式化，而是编辑器视觉层的软换行（soft wrap），必须手动开启且按文件类型单独配置，否则长行永远横向滚动。
怎么打开软换行总开关并默认对 PHP/JS 文件生效
很多人在 Settings → Editor → General 里只勾了 Use soft wraps in editor 就以为万事大吉——其实这只是总开关，新打开的文件才可能继承；真正决定“.php”“.js”文件一打开就自动折行的，是下方的扩展名白名单。
- 进入
Settings → Editor → General → Soft Wraps - 勾选
Use soft wraps in editor - 在
Soft wraps in files with extensions输入框里填入：php,js,ts,html,css,md（逗号分隔，不加空格） - 点击
OK，已打开的文件需手动右键 →Soft-Wrap开启，新打开的匹配后缀文件会自动启用
为什么开了还是不换行？三个高频干扰点
软换行失效，90% 不是设置错了，而是被其他因素覆盖或阻断：
-
String Manipulation或Key Promoter X插件在某些版本中会劫持渲染逻辑，临时禁用它们可验证是否插件冲突 - 当前文件被识别为错误类型（比如后缀是
.php，但 PhpStorm 把它当成了Text），右下角状态栏看文件类型，右键 →Override File Type改回PHP - 全屏模式（
Ctrl+Shift+F12）下软换行有时被强制关闭，退出全屏再试
软换行和代码格式化（Ctrl+Alt+L）是两码事
有人希望“自动换行”能帮自己把超长数组、函数调用拆成多行——这是混淆了 soft wrap 和 code style wrapping。前者只是眼睛看到的折行，后者才是真实插入换行符和缩进。
立即学习“PHP免费学习笔记（深入）”；
- 若想让
array()或foo($a, $b, $c)在格式化时自动换行，要去Settings → Editor → Code Style → PHP → Wrapping and Braces - 重点调这几个：
Function call arguments设为Chop down if long，Array initializer同样设为Chop down if long -
Right margin (columns)建议设为120，它不控制显示，但决定格式化时的断行依据
别指望软换行解决运行时输出问题
开了软换行，echo "一大段没有换行符的字符串"; 在浏览器里依然挤成一行——因为软换行只作用于 PhpStorm 编辑器界面，完全不参与 PHP 解析、HTML 渲染或 CLI 输出。
- 前端显示长文本要换行：加 CSS
white-space: pre-wrap;或word-break: break-word; - CLI 输出需要折行：用
wordwrap()函数或手动拼\n - 调试大数组别靠眼盯源码：点变量旁的
?图标用结构化查看器，比数软换行靠谱得多
软换行本质是阅读辅助，不是代码治理工具。它帮你少拖水平滚动条，但不会替你写语义清晰的代码，也不会让 Git 提交或终端输出变友好——这些都得靠对应场景的专门手段。
