如何在 VSCode 中禁用 Python 多行函数调用中括号的自动缩进

VSCode 作为主流的 Python 开发编辑器，默认开启了多种代码自动格式化功能，其中就包含多行函数调用时括号的自动缩进规则，不少开发者觉得这种默认缩进不符合自己的编码习惯，想要关闭该功能。本文会介绍具体的操作方案。

问题现象说明

当你在 VSCode 中编写 Python 多行函数调用代码时，按下回车键后，编辑器会自动将后续的参数行缩进到和左括号对齐的位置，类似下面的格式：

def test_func(a, b, c):
    pass

# 默认自动缩进后的效果
test_func(
    a=1,
    b=2,
    c=3
)

很多开发者更习惯参数和函数名对齐的格式，或者希望完全不自动缩进，这就需要调整相关配置。

方法一：修改 VSCode 内置 Python 缩进设置

VSCode 的 Python 扩展提供了专门的缩进相关配置项，你可以直接修改用户设置来关闭该自动缩进。

操作步骤

1. 打开 VSCode，按下快捷键 Ctrl+Shift+P（Mac 系统是 Cmd+Shift+P）打开命令面板
2. 输入 Preferences: Open User Settings (JSON) 并回车，打开 settings.json 配置文件
3. 添加以下配置项到文件中：

{
    // 关闭 Python 多行函数调用括号的自动缩进
    "python.analysis.autoFormatting.indentSize": null,
    // 禁用 Python 扩展的自动缩进规则
    "python.analysis.autoIndent": "none"
}

保存配置文件后，重启 VSCode 即可生效。

方法二：调整代码格式化工具配置

如果你使用了 autopep8、black 等代码格式化工具，这些工具的默认规则也可能导致括号自动缩进，需要调整对应工具的配置。

以 black 为例的配置修改

black 是 Python 社区常用的无争议格式化工具，默认会对多行函数调用的括号做缩进处理，你可以通过配置文件关闭该规则。

在项目根目录创建 pyproject.toml 文件，添加以下内容：

[tool.black]
# 禁用多行函数调用括号的自动缩进
skip-multiline-string-ranges = []
# 不自动调整括号缩进
line-length = 88
# 关闭括号自动换行缩进
skip-source-first-line = false

同时在 VSCode 的 settings.json 中确保 black 作为默认格式化工具：

{
    "python.formatting.provider": "black",
    "editor.formatOnSave": true
}

方法三：临时关闭自动格式化

如果你只是偶尔需要禁用该缩进，不需要永久修改配置，可以临时关闭自动格式化功能。

按下快捷键 Ctrl+Shift+I（Mac 系统是 Cmd+Shift+I）可以快速切换当前文件的自动格式化开关，关闭后编辑器就不会自动调整括号缩进了。

效果验证

配置完成后，你可以输入以下代码测试效果：

# 输入后按下回车，不会再自动缩进参数行
test_func(
a=1,
b=2,
c=3
)

如果参数行没有自动缩进到和左括号对齐的位置，说明配置已经生效。

注意事项

• 修改 settings.json 配置时，注意不要写重复的配置项，否则后面的配置会覆盖前面的
• 不同的 Python 格式化工具配置方式不同，需要根据你实际使用的工具调整对应配置
• 如果配置后没有生效，可以检查是否有其他扩展覆盖了缩进规则，或者重启 VSCode 让配置生效

VSCodePython自动缩进settings_json代码格式化修改时间：2026-06-17 12:42:33