PhpStorm中“自动软换行”不依赖长度阈值，仅响应编辑器可视宽度；需在Settings→Editor→General→Soft Wraps勾选总开关，并在Soft wraps in files with extensions中填php,js,ts等后缀才能默认生效，且受全屏模式、文件识别类型及插件干扰。
PhpStorm 里“自动软换行”不是靠调长度阈值实现的，它只响应编辑器可视宽度，和字符数无关；真正影响长代码显示体验的是 Soft Wraps 开关 + 文件类型白名单 + 全屏模式干扰这三件事。
怎么打开软换行并让它对 PHP/JS/TS 文件默认生效
很多人在 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—— 留空就等于只对当前已打开的文件手动开启 - 改完不用重启，新开一个
.php文件就能看到效果
为什么开了软换行，新打开的文件还是不折行
软换行静默失效的三大高频原因：
- 当前文件右下角显示的语言模式不是
PHP（比如被识别成Text或Vue SFC Script），折叠/换行规则直接不加载 - 启用了全屏模式（
F11或Ctrl+Shift+F12），软换行会被强制关闭，退出即可恢复 - 插件干扰，尤其是
String Manipulation或老版本Key Promoter X，临时禁用可验证
注意：Soft Wraps 不修改源码，Git 提交、echo 输出、var_dump() 显示都不受影响——它只是帮你少拖横向滚动条。
立即学习“PHP免费学习笔记（深入）”；
软换行和右边界（Right margin）别混着用
这两个机制完全独立，混用反而容易困惑：
-
Soft Wraps：纯视觉折行，随窗口拉宽/缩窄实时变化，和Right margin值无关 -
Right margin（在Code Style → PHP → Wrapping and Braces里设）：只影响Ctrl+Alt+L格式化时的断行逻辑，打字时不会自动插入换行符 - 想让输入接近 120 列时有提示？得额外勾选
Wrap when typing reaches right margin，但这提示依赖软换行开启才能被你“看见”
字符串字面量、正则表达式、注释这些结构，Right margin 基本不生效，别指望它来折断 echo "超长HTML字符串"。
region 折叠和软换行是两套东西，别指望它们联动
有人写完 // region 还想让里面的内容自动软换行，这是误解：
-
// region是代码折叠功能，归Code Folding设置管，必须单独勾选Custom folding regions -
// region注释本身必须独占一行，前后不能有空格或代码，否则 PhpStorm 直接忽略 - 即使 region 折叠成功，里面那段超长 SQL 或数组也不会因此获得更好的软换行效果——该不折还是不折，除非你手动调宽编辑器
真正容易被忽略的是：软换行在只读文件、BOM 头存在、PSI 解析失败（比如语法错误未修复）时会静默退场，而这些问题往往没有明显报错提示。
