PhpStorm 中长代码不自动折行需开启软换行（Soft Wraps）功能：在 Settings → Editor → General → Soft Wraps 勾选总开关，并在扩展名框中填入 php,js,ts 等后缀以设默认启用；该功能仅影响编辑器显示，不修改源码，且受全屏模式、文件识别类型及插件干扰。
PhpStorm 里长代码不自动折行？先确认是否开了软换行
默认情况下 phpstorm 不会视觉上折行长代码，哪怕窗口很窄——它只是横向滚动。所谓“自动换行”，其实是编辑器的「软换行（soft wraps）」功能，和代码逻辑无关，纯属显示层设置。
- 软换行只影响你眼睛看到的换行，
Enter键实际插入的换行符不会变，Git 提交、运行时行为完全不受影响 - 它不修改源码，所以不会污染
.php或.js文件里的真实换行位置 - 该设置是按文件类型独立生效的，比如你给
.php开了，.json默认还是关的
怎么打开软换行：别在 Editor → General 里瞎找全局开关
很多人卡在这一步：去 Settings → Editor → General 找 “Wrap lines” 结果没找到——因为那个选项只控制「当前文件是否启用」，不是全局默认。真正设默认值的地方藏得有点深。
- 进
Settings → Editor → General → Soft Wraps - 勾选
Use soft wraps in editor—— 这是总开关，但只对新打开的文件生效 - 重点：在下方
Soft wraps in files with extensions输入框里填上你要默认开启的后缀，比如：php,js,ts,html,css,md - 如果留空，就只对当前已打开的文件手动开启（右键编辑区 →
Soft-Wrap）
为什么有时开了也不生效？检查这三处干扰项
软换行被禁用，90% 是因为下面某个地方覆盖了设置，而不是功能坏了。
- 当前文件处于「全屏编辑模式」（
F11或Ctrl+Shift+F12），软换行会被强制关闭——退出全屏即可恢复 - 文件绑定了「只读」或「二进制」识别模式（比如误把
.log当成文本打开），软换行不可用；右键标签页 →Reload as Text可修复 - 用了第三方插件如
String Manipulation或Key Promoter X，极少数版本会劫持渲染层导致软换行失效；临时禁用插件可验证
PHP 特别注意：不要指望软换行解决 echo 长字符串截断问题
有人以为开了软换行，echo "很长很长..."; 就能在浏览器里自动换行显示——这是误解。软换行只作用于 PhpStorm 编辑器界面，不影响 PHP 运行时输出。
- 若想让 HTML 页面里长文本折行，得加 CSS：
white-space: pre-wrap;或word-break: break-word; - 若想在 CLI 输出中换行，得自己用
\n或wordwrap()函数处理，soft wrap完全不参与 - 调试时看
var_dump()的长数组，建议用「结构化查看器」（点击变量旁的小眼镜图标），比依赖编辑器换行靠谱得多
软换行本质是个阅读辅助功能，不是代码格式化工具。它帮你少拖滚动条，但不会帮你改代码、修逻辑、适配终端——这些都得另想办法。
立即学习“PHP免费学习笔记（深入）”；
