VS Code编写Python时自动换行 保存后代码拆分为多行如何解决

问题根源 #

保存时代码被强制拆分多行，并非编辑器自带的换行功能，是保存时触发的Python代码格式化工具按照内置规则主动修改了文件内容，和仅改变显示效果的软换行无关。最常见的触发源为Python扩展默认绑定的autopep8、Black、yapf三类格式化工具。

解决方案 #

方案1：直接关闭保存时自动格式化 #

如果不需要保存时自动格式化能力，直接关闭触发入口即可：

• 按下快捷键Ctrl+,（Windows/Linux）/Cmd+,（Mac）打开VS Code设置面板
• 搜索配置项editor.formatOnSave，取消对应选项的勾选，后续保存文件时不会触发任何自动格式化修改。

方案2：保留自动格式化，仅调整拆行规则 #

如果需要保留其他格式化能力，仅取消不必要的自动拆行，根据当前使用的格式化器对应修改配置即可：

• Black格式化器：Black默认行宽阈值为88字符，只要代码长度触发阈值就会强制拆分括号内参数。在设置中搜索python.formatting.blackArgs，添加参数--line-length=120（数值可按个人编码习惯调整，设置为160可覆盖绝大多数单行代码场景），即可提高拆行阈值。如果是项目级配置，可在项目根目录pyproject.toml中写入如下配置：

[tool.black]
line-length = 120

• autopep8格式化器：autopep8默认遵循PEP8规范的79字符行宽阈值，在设置中搜索python.formatting.autopep8Args，添加参数--max-line-length=120即可调高拆行阈值；如果要完全关闭行宽触发的拆行，可额外添加--ignore=E501,E128，忽略行长度校验、续行缩进相关的拆分规则。
• yapf格式化器：在设置中搜索python.formatting.yapfArgs，添加参数--style={based_on_style: pep8, column_limit: 120, split_before_named_assigns: False}即可调高行宽限制，关闭不必要的参数拆行。

方案3：排查软换行误判 #

如果保存后文件实际内容没有被拆分，只是视觉上显示为多行，是开启了编辑器软换行功能，直接按下快捷键Alt+Z即可切换软换行开关，该功能仅调整显示效果，不会修改代码实际内容。

验证方式 #

将被拆分的代码恢复为目标单行格式：

ap.add_argument("-p", "--path", help="path", default="C:\Data\file.txt")

执行保存操作，代码保持单行即为配置生效。

内容的提问来源于stack exchange，提问作者user18408957