VSCode默认不换行是设计使然，需设"editor.wordWrap": "on"并确保Python语言专属设置不覆盖，才能让长字符串按视口宽度软折行；快捷键Alt+Z可临时切换，但仅会话生效。
VSCode 默认不换行长字符串，哪怕它横跨屏幕十几倍宽——这不是 bug，是设计。要让它视觉上折行，得明确告诉编辑器“按视口宽度折”，而不是指望格式化工具或语言服务自动插 \n。
为什么 Python 文件里长字符串还是横向滚动？
常见现象：一段 SQL 查询、JSON 字符串或 docstring 超过 200 字符，但编辑器没折行，必须拖动水平滚动条。
- 根本原因不是 Python 插件没生效，而是
editor.wordWrap默认为"off"，且语言专属设置可能覆盖了全局配置 - 右下角点开语言标识（比如显示
Python），再点「Configure 'Python' language based settings」，常会发现里面写了"editor.wordWrap": "off"—— 这比用户设置优先级高 -
autopep8或black格式化器只改真实换行符，对视觉换行完全无感；它们不会响应editor.wordWrap
怎么让 Python 文件真正启用视觉换行？
必须同时满足两个条件：全局开关打开 + Python 语言层不拦截。
- 在
settings.json中确保有这两项（顺序无关）："editor.wordWrap": "on",<br>"[python]": {<br> "editor.wordWrap": "on"<br>} - 不要只依赖图形界面点选「Editor: Word Wrap」——它可能只写进工作区设置，而 Python 文件常读的是语言专属设置
- 快捷键
Alt+Z（Windows/Linux）或Option+Z（macOS）可临时切换当前文件，但只是会话级，关文件就失效 - 验证是否生效：打开一个含长字符串的
.py文件，用鼠标滚轮横向拖一下，如果还能拖，说明没生效；如果拖不动、内容自动折到下一行，才算成功
wordWrap: "on" 和 wordWrapColumn 有什么实际区别？
对 Python 长字符串来说，选错模式会导致阅读体验反向恶化。
立即学习“Python免费学习笔记（深入）”；
-
"on"：纯响应式。窗口拉宽，字符串立刻展开成一行；缩窄，立刻折行。适合边写边看日志、SQL 或 API 返回体 -
"wordWrapColumn"：强制在固定列断开，比如设"editor.wordWrapColumn": 120，那哪怕你用 4K 屏，第 121 个字符也一定折下去——但 Python 的缩进和括号匹配逻辑容易被视觉折行干扰，尤其嵌套字典里 -
"bounded"行为不稳定：它取min(视口宽度, wordWrapColumn)，窗口微调时折行点跳变，调试时定位光标反而更难 - 中文、URL、base64 等无空格长串，所有模式都按字符数硬切，不会识别语义边界；想避免截断，只能靠
wrappingIndent调整第二行缩进（默认"same"），但效果有限
最易被忽略的一点：终端、调试控制台、输出面板这些区域，editor.wordWrap 完全不生效——它们有自己的渲染逻辑。别指望在「调试」标签页里看到折行的长字符串输出。
