Ruff 当前不支持全局禁用换行重排，但可通过 # fmt: skip 注释精准跳过特定表达式的格式化，从而保留可读性强的多行链式调用或参数列表。
ruff 当前不支持全局禁用换行重排，但可通过 # fmt: skip 注释精准跳过特定表达式的格式化，从而保留可读性强的多行链式调用或参数列表。
Ruff 的格式化器（ruff format）以简洁、一致为设计目标，因此默认会将符合长度限制的多行链式调用（如 .str.strip().str.replace(...)）或带换行的函数调用（如 pd.melt(df, id_vars=[...])）自动折叠为单行。虽然这提升了代码的紧凑性，但在处理复杂数据转换逻辑时，多行结构能显著提升可维护性与可读性——尤其是涉及 pandas 链式操作或嵌套字典/参数时。
遗憾的是，截至当前最新稳定版本（v0.7+），Ruff 并未提供类似 --preserve-linebreaks 或配置项来全局禁用换行优化。官方 GitHub 仓库中已明确确认该功能暂未实现（参见 issue #8598）。skip-magic-trailing-comma 等选项仅影响逗号行为，无法阻止换行折叠。
不过，存在一个轻量、精准且被社区验证有效的替代方案：在需要保留格式的表达式末尾添加 # fmt: skip 注释。该指令作用于其所在行的整个语句（包括跨多行的表达式），Ruff 将完全跳过对该语句的格式化，同时不影响其余代码。
以下为实际应用示例：
import pandas as pd
df = pd.DataFrame(
{
"A": [" a: yu", "b: stuff ", "c: more_stuff"],
"B": [4, 5, 6],
"C": [7, 8, 9],
}
)
# ✅ 多行链式调用保持原样
df["A"] = (
df["A"]
.str.strip()
.str.replace(":", "")
.str[0]
) # fmt: skip
# ✅ 多行函数调用不受干扰
new_df = pd.melt(
df,
id_vars=["A"]
) # fmt: skip
print(new_df)
⚠️ 注意事项：
# fmt: skip必须写在语句的最后一行末尾（即闭合括号)或]所在行），不可放在中间或单独成行；- 它作用于整个语句，而非某一行，因此适用于
if、for、赋值、函数调用等多种复合结构；- 相比
# fmt: off/on块注释，# fmt: skip更细粒度、无侵入性，避免大段代码脱离格式管控；- 若项目中此类语句较多，建议结合编辑器插件（如 VS Code 的 Ruff 扩展）快速插入注释，提升效率。
总结而言，虽然 Ruff 尚未提供“禁止触碰换行”的全局开关，但 # fmt: skip 是目前最务实、可控且低维护成本的解决方案。它在坚守自动化格式化原则的同时，为开发者保留了对关键可读性结构的手动干预权——真正的工程平衡之道，不在于全有或全无，而在于精准留白。
