如何配置Vim/Neovim自动检测Python项目的缩进类型？

方法一：纯.vimrc/init.vim配置（无需插件） #

直接通过自定义函数+自动命令，让Vim打开文件时自动分析缩进风格：

1. 添加缩进检测函数到配置文件：

function! DetectIndentType()
    " 统计文件中空格缩进、制表符缩进的有效行数
    let space_lines = 0
    let tab_lines = 0
    let total_lines = 0

    " 遍历非空行，排除Python注释行
    for line in getline(1, '$')
        let trimmed = substitute(line, '^\s*', '', '')
        if empty(trimmed) || trimmed[0] == '#'
            continue
        endif

        let leading_chars = matchstr(line, '^\s*')
        if stridx(leading_chars, "\t") != -1
            let tab_lines += 1
        else
            let space_lines += 1
        endif
        let total_lines += 1
    endfor

    " 空文件用默认配置（可自行修改）
    if total_lines == 0
        set expandtab
        set shiftwidth=4
        set tabstop=4
        set softtabstop=4
        return
    endif

    " 根据占比设置缩进类型
    if tab_lines > space_lines
        set noexpandtab
        " 自动识别制表符对应的缩进宽度
        let tab_widths = []
        for line in getline(1, '$')
            let leading_tabs = matchstr(line, '^\t\+')
            if !empty(leading_tabs)
                let tab_count = strlen(leading_tabs)
                let next_char_pos = tab_count
                while next_char_pos < strlen(line) && line[next_char_pos] == ' '
                    let next_char_pos += 1
                endfor
                if next_char_pos > tab_count
                    call add(tab_widths, next_char_pos - tab_count)
                endif
            endif
        endfor
        let target_width = !empty(tab_widths) ? mode(tab_widths) : 4
        set shiftwidth=target_width
        set tabstop=target_width
        set softtabstop=target_width
    else
        set expandtab
        " 自动识别空格缩进宽度
        let space_widths = []
        for line in getline(1, '$')
            let leading_spaces = matchstr(line, '^\s*')
            if stridx(leading_spaces, "\t") == -1 && !empty(leading_spaces)
                let indent_len = strlen(leading_spaces)
                let possible_widths = filter(range(1, indent_len), 'indent_len % v:val == 0')
                call extend(space_widths, possible_widths)
            endif
        endfor
        let target_width = !empty(space_widths) ? mode(space_widths) : 4
        set shiftwidth=target_width
        set tabstop=target_width
        set softtabstop=target_width
    endif
endfunction

" 辅助函数：找出列表中出现次数最多的元素
function! mode(list)
    let counts = {}
    for item in a:list
        let counts[item] = get(counts, item, 0) + 1
    endfor
    let max_count = max(values(counts))
    for item in keys(counts)
        if counts[item] == max_count
            return item + 0 " 转为数字类型
        endif
    endfor
    return 4
endfunction

2. 添加自动命令触发检测：

autocmd BufEnter *.py call DetectIndentType()
autocmd BufNewFile *.py call DetectIndentType()

这个配置会自动统计当前Python文件中占比更高的缩进类型，同时识别对应的缩进宽度，完全适配现有代码格式。

方法二：用插件简化配置 #

不想写复杂函数的话，直接用成熟插件更省心：

1. vim-sleuth #

轻量插件，自动分析当前文件的缩进风格，无需额外配置。它会检测文件中已有的缩进模式，自动设置expandtab/noexpandtab、shiftwidth等参数，开箱即用。

2. editorconfig-vim #

适合团队协作场景，读取项目根目录的.editorconfig文件来应用配置。不同项目可以单独定义：

• 空格缩进的项目：

[*.py]
indent_style = space
indent_size = 4

• 制表符缩进的项目：

[*.py]
indent_style = tab
indent_size = 4

切换项目时，Vim会自动读取对应配置，统一缩进规则。

注意事项 #

• 空文件默认用4空格缩进，可在DetectIndentType函数的空文件分支修改默认值。
• 个人项目优先选vim-sleuth，团队项目更适合editorconfig-vim。

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