Vim中popup_menu回调执行顺序异常，如何返回选中文件？

问题原因 #

Vim的popup_menu()是异步非阻塞API：它完成弹窗创建后会立刻返回弹窗的ID（也就是你看到BAR消息里的数字），不会暂停函数执行等待用户操作。因此ListFiles函数会按顺序执行完echom "BAR..."和return语句，直到函数结束；只有当用户在弹窗中完成选择（或关闭弹窗）时，才会触发s:HandleFileSelection回调函数，这就是FOO消息延迟出现的原因。

解决方法：让函数同步返回选中项 #

要实现函数直接返回用户选中的文件，需要将异步逻辑改为同步阻塞的方式，以下是两种可行方案：

方案1：用inputlist()替代（简单直接） #

inputlist()是Vim内置的同步选择函数，会阻塞到用户完成选择，直接返回选中项的索引，函数可以立刻拿到结果并返回：

function! ListFiles(dir, title)
  let l:dir = a:dir
  let l:title = a:title
  let l:files = glob(l:dir . '/*', 0, 1)
  let l:file_list = map(l:files, 'fnamemodify(v:val, ":t")')

  " 生成同步选择菜单，用户操作前函数会阻塞
  let l:selected_idx = inputlist([l:title] + l:file_list)
  let l:selected_file = (l:selected_idx > 0 && l:selected_idx <= len(l:file_list)) ? l:file_list[l:selected_idx - 1] : ""

  echom "选中的文件：" . l:selected_file
  return l:selected_file
endfunction

方案2：基于popup_menu()实现同步阻塞（保留弹窗样式） #

如果想保留popup_menu的自定义UI样式，可以利用Vim的v:waitpopupvar变量实现阻塞等待，核心是用脚本变量存储选择结果，直到用户操作完成：

function! ListFiles(dir, title)
  let l:dir = a:dir
  let l:title = a:title
  let l:files = glob(l:dir . '/*', 0, 1)
  let l:file_list = map(l:files, 'fnamemodify(v:val, ":t")')

  " 定义自定义高亮组
  highlight PopupMenu guifg=#ffffff guibg=#333333 ctermfg=white ctermbg=darkred
  highlight PopupMenuSelected guifg=#000000 guibg=#ffff00 ctermfg=black ctermbg=yellow

  " 初始化存储结果的脚本变量
  let s:selected_result = ""

  " 创建弹窗，回调函数负责赋值选择结果
  call popup_menu(l:file_list, {
        \ 'title': ' ' . l:title . ' ',
        \ 'callback': 's:HandleFileSelectionSync',
        \ 'line': &lines / 2,
        \ 'col': &columns / 2,
        \ 'highlight': 'PopupMenu',
        \ 'border': [],
        \ 'close': 'click',
        \ 'padding': [1, 2, 1, 2],
        \ 'mapping': 0,
        \ 'filter': 'popup_filter_menu',
        \ 'wrap': 0
        \ })

  " 阻塞等待用户完成操作，直到s:selected_result被赋值
  let v:waitpopupvar = s:selected_result

  " 返回最终选中的文件
  echom "选中的文件：" . s:selected_result
  return s:selected_result
endfunction

" 同步回调函数：赋值结果并通知等待的函数继续执行
function! s:HandleFileSelectionSync(id, result)
  if a:result != -1
    let s:selected_result = getbufline(winbufnr(a:id), a:result)[0]
  else
    let s:selected_result = ""
  endif
  let v:waitpopupvar = s:selected_result
endfunction

方案对比 #

• 方案1：代码简洁，无需额外回调逻辑，但UI是Vim原生的基础列表样式，无法自定义高亮和布局。
• 方案2：保留了popup_menu的自定义UI能力，但需要额外处理同步变量和阻塞逻辑，代码稍复杂。

内容的提问来源于stack exchange，提问作者M.E.