" ============ Ctags 配置 ============

" 标签文件搜索路径
" 从当前文件所在目录向上逐级查找 tags 文件
set tags=./tags;,tags

" 解释：
" ./tags  — 当前目录下的 tags
" ;       — 向上递归查找（重要！）
" ,tags   — 当前工作目录下的 tags

" 大项目可能需要增大标签栈大小
set tagstack

" 启用文件类型检测（推荐）
filetype plugin on

" ===== 跳转类 =====
" 跳转到光标下的符号定义
<C-]>                    " 或 :tag <symbol>

" 跳转到精确匹配的标签（当有多个匹配时）
g<C-]>                   " 列出所有匹配，让用户选择

" 跳转并选择（模糊匹配）
:tag /pattern            " 模糊搜索
:tselect /pattern        " 搜索并列出候选

" 跳转到第 N 个匹配
:tag /pattern{N}         " 如 :tag /main{2} 跳到第二个 main

" ===== 预览窗口 =====
" 在预览窗口中打开定义（不离开当前文件）
<C-w>}                   " 或 :ptag <symbol>

" 预览窗口中跳转
<C-w>]                   " 水平分割并跳转
<C-w><C-]>               " 垂直分割并跳转

" 关闭预览窗口
:pclose

" ===== 返回类 =====
<C-t>                    " 弹出标签栈，返回上一个位置
:pop                     " 同 <C-t>
:tnext                   " 跳到下一个匹配标签
:tprev                   " 跳到上一个匹配标签
:tfirst                  " 跳到第一个匹配标签
:tlast                   " 跳到最后一个匹配标签

" ===== 标签栈查看 =====
:tags                    " 显示标签栈历史

" ============ 标签补全 ============

" Vim 内置的标签补全（插入模式）
<C-x><C-]>              " 基于标签文件的补全

" 常用补全组合键
<C-n>                    " 普通关键字补全
<C-x><C-n>              " 当前缓冲区关键字
<C-x><C-]>              " 标签文件补全（Ctags 专用）
<C-x><C-f>              " 文件名补全

" 将标签补全加入全能补全列表
set complete+=t          " t 表示 tags

" ============ 自动化方案 ============

" 方案一：保存文件时自动更新标签（最简单）
autocmd BufWritePost *.c,*.h,*.py,*.js
    \ silent! !ctags -R --append=yes %

" 方案二：使用 augroup（更规范）
augroup AutoCtags
    autocmd!
    autocmd BufWritePost * call UpdateCtags()
augroup END

function! UpdateCtags()
    let l:ext = expand('%:e')
    let l:langs = {'c': 'C', 'h': 'C', 'py': 'Python',
                 \ 'js': 'JavaScript', 'ts': 'TypeScript'}
    if has_key(l:langs, l:ext)
        silent! call system('ctags -R --append=yes ' . expand('%'))
    endif
endfunction

" 自动标签管理插件
Plug 'ludovicchabant/vim-gutentags'

" gutentags 配置
let g:gutentags_project_root = ['.root', '.git', '.svn']
let g:gutentags_ctags_tagfile = '.tags'
let g:gutentags_cache_dir = expand('~/.cache/tags')

" 自动生成 tags 文件的命令
let g:gutentags_modules = []
if executable('ctags')
    let g:gutentags_modules += ['ctags']
endif

" 排除目录
let g:gutentags_ctags_extra_args = [
    \ '--exclude=.git',
    \ '--exclude=node_modules',
    \ '--exclude=.venv',
    \ '--exclude=vendor',
    \ ]

" 字段配置
let g:gutentags_ctags_extra_args += [
    \ '--fields=+S',
    \ '--sort=yes',
    \ ]

" 使用 fzf 模糊搜索标签
Plug 'junegunn/fzf.vim'

" :Tags 命令搜索所有标签
" :BTags 命令搜索当前缓冲区标签

" 快捷键映射
nnoremap <Leader>t :Tags<CR>
nnoremap <Leader>T :BTags<CR>

" 侧栏符号浏览器
Plug 'liuchengxu/vista.vim'

" 使用 ctags 作为后端
let g:vista_ctags_executable = 'ctags'
let g:vista_default_executive = 'ctags'

" 快捷键
nnoremap <F8> :Vista!!<CR>

" 显示符号类型
let g:vista_icon_indent = ["╰─▸ ", "├─▸ "]

# 使用 ctags 的 -e 选项生成 Emacs 格式
ctags -e -R .

# 输出文件默认名为 TAGS（大写）

# 或指定输出文件名
ctags -e -R -o TAGS .

;; ===== Ctags / TAGS 配置 =====

;; 设置 TAGS 文件搜索路径
(setq tags-table-list '("./TAGS" "../TAGS"))

;; 自动向上查找 TAGS 文件
(setq tags-add-tables t)

;; 查找标签时区分大小写
(setq tags-case-fold-search nil)

;; 增大标签环大小
(setq find-tag-marker-ring-length 32)

;; 使用 Helm 进行标签搜索
(use-package helm
  :config
  (global-set-key (kbd "M-.") 'helm-ctags-find-tag)
  (global-set-key (kbd "C-c t s") 'helm-etags-select))

;; 或使用 consult（Vertico 生态）
(use-package consult
  :bind
  ("M-." . consult-ctags)
  ("C-c t s" . consult-etags))

;; 保存文件时自动更新 TAGS
(defun my/update-etags ()
  "Update TAGS file for current project."
  (when (and (buffer-file-name)
             (string-match-p "\\.[ch]pyjs\\'" (buffer-file-name)))
    (let ((default-directory (projectile-project-root)))
      (async-shell-command
       (format "ctags -e -R -o TAGS --append=yes %s"
               (buffer-file-name))))))

(add-hook 'after-save-hook #'my/update-etags)

{
    "ctagsx.ctagsPath": "ctags",
    "ctagsx.ctagsFile": "tags",
    "ctagsx.autoBuildTags": true,
    "ctagsx.autoBuildTagsOnSave": true,
    "ctagsx.enableCompletions": true,
    "ctagsx.enableHover": true,
    "ctagsx.enableSearchAll": true,

    // 自定义参数
    "ctagsx.args": [
        "--fields=+S",
        "--sort=yes",
        "--exclude=node_modules",
        "--exclude=.git"
    ]
}

{
    // 跳转到定义
    "ctrl+]": "ctagsx.jumpToTag",
    // 返回
    "ctrl+t": "ctagsx.jumpBack",
    // 搜索标签
    "ctrl+shift+t": "ctagsx.searchTag",
    // 显示当前文件符号
    "ctrl+shift+o": "ctagsx.showDocumentSymbols"
}

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Generate Ctags",
            "type": "shell",
            "command": "ctags",
            "args": [
                "-R",
                "--fields=+S",
                "--sort=yes",
                "--exclude=node_modules",
                "--exclude=.git",
                "--exclude=.venv",
                "."
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": []
        }
    ]
}

{
    "files.watcherExclude": {
        "**/tags": false
    },
    "ctagsx.autoBuildOnFileCreate": true,
    "ctagsx.autoBuildOnFileDelete": true,
    "ctagsx.autoBuildOnFileRename": true
}

// Preferences.sublime-settings
{
    "index_files": true,
    "ctags_command": "ctags -R --fields=+S",
    "ctags_auto_build": true
}

-- init.lua
-- Neovim 原生支持 tags
vim.opt.tags = './tags;,tags'

-- 结合 telescope.nvim 搜索标签
local builtin = require('telescope.builtin')
vim.keymap.set('n', '<leader>tt', builtin.tags, { desc = 'Search tags' })
vim.keymap.set('n', '<leader>tr', builtin.tagstack, { desc = 'Tag stack' })

-- 使用 vim-gutentags（如果需要自动管理）
vim.g.gutentags_ctags_tagfile = '.tags'
vim.g.gutentags_cache_dir = vim.fn.expand('~/.cache/tags')

" 打开预览窗口
:ptag symbol_name

" 用快捷键预览光标下的符号
<C-w>}

" 在预览窗口中执行命令
:ptnext            " 预览下一个匹配
:ptprev            " 预览上一个匹配
:ptfirst           " 预览第一个匹配

" 关闭预览窗口
:pclose

" 预览窗口配置
set previewheight=10     " 预览窗口高度
" autocmd FileType * set previewheight=15

" 启用文件类型检测
filetype plugin on

" 设置 omnifunc
autocmd FileType c set omnifunc=ccomplete#Complete
autocmd FileType python set omnifunc=pythoncomplete#Complete
autocmd FileType javascript set omnifunc=javascriptcomplete#CompleteJS

" <C-x><C-o> 触发全能补全
" <C-x><C-]> 触发标签补全

" 设置补全来源优先级
set complete=.,w,b,u,t,i

" .  当前缓冲区
" w  其他窗口的缓冲区
" b  其他加载的缓冲区
" u  未加载的缓冲区
" t  标签文件（Ctags）
" i  包含文件

" 确保标签补全被包含
set complete+=t

" coc.nvim 可以将 Ctags 作为补全来源
Plug 'neoclide/coc.nvim'

" 在 coc-settings.json 中添加：
" {
"   "coc.source.ctags.enable": true,
"   "coc.source.ctags.priority": 50
" }

" ============ 标签跳转优化 ============

" 自定义跳转函数：先尝试 LSP，再尝试 Ctags
function! SmartTagJump()
    if exists('*lsp#jump') && lsp#is_active()
        LspDefinition
    else
        tag <C-R><C-W>
    endif
endfunction

nnoremap <C-]> :call SmartTagJump()<CR>

" 标签栈可视化
nnoremap <Leader>ts :tags<CR>

" 快速搜索标签
nnoremap <Leader>tg :tag /

" 模糊搜索所有标签（需要 fzf.vim）
nnoremap <Leader>tt :Tags<CR>

" 预览定义
nnoremap <Leader>tp :ptag <C-R><C-W><CR>