# 1. 生成 cscope 数据库
find . -name "*.c" -o -name "*.h" > cscope.files
cscope -b -q -i cscope.files

# 2. 生成 Ctags 标签文件（包含 cscope 信息）
ctags -R --c-kinds=+def+p --fields=+S .
# 等价于
# ctags -R --c++-kinds=+p --fields=+iaS --extra=+q .

" ~/.vimrc

" 检测并加载 cscope 数据库
if has("cscope")
    set cscopetag          " 同时使用 cscope 和 ctags
    set csto=0             " 先搜索 cscope，再搜索 ctags
    set cst                " 同时搜索 cscope 和 tags 数据库
    set nocsverb

    " 添加 cscope 数据库
    if filereadable("cscope.out")
        cs add cscope.out
    elseif $CSCOPE_DB != ""
        cs add $CSCOPE_DB
    endif

    set csverb
endif

" cscope 快捷键映射
" s: 查找 C 符号
nmap <C-\>s :cs find s <C-R>=expand("<cword>")<CR><CR>
" g: 查找定义
nmap <C-\>g :cs find g <C-R>=expand("<cword>")<CR><CR>
" c: 查找调用此函数的函数
nmap <C-\>c :cs find c <C-R>=expand("<cword>")<CR><CR>
" t: 查找文本字符串
nmap <C-\>t :cs find t <C-R>=expand("<cword>")<CR><CR>
" e: 查找 egrep 模式
nmap <C-\>e :cs find e <C-R>=expand("<cword>")<CR><CR>
" f: 查找文件
nmap <C-\>f :cs find f <C-R>=expand("<cfile>")<CR><CR>
" i: 查找包含此文件的文件
nmap <C-\>i :cs find i ^<C-R>=expand("<cfile>")<CR>$<CR>
" d: 查找被此函数调用的函数
nmap <C-\>d :cs find d <C-R>=expand("<cword>")<CR><CR>

#!/bin/bash
# gen_cscope_ctags.sh - 同时生成 cscope 和 ctags 数据库

set -e

echo "=== Generating cscope database ==="
find . -name "*.c" -o -name "*.h" -o -name "*.cpp" -o -name "*.hpp" \
    | grep -v '.git' | grep -v 'build/' > cscope.files
cscope -b -q -i cscope.files

echo "=== Generating ctags database ==="
ctags -R \
    --c-kinds=+def+p \
    --c++-kinds=+def+p \
    --fields=+S+n \
    --extras=+q \
    --sort=yes \
    .

echo "Done. Generated:"
echo "  cscope.out: $(wc -l < cscope.files) source files"
echo "  tags:       $(grep -cv '^!_' tags) tags"

# Ubuntu/Debian
sudo apt install global

# Fedora/RHEL
sudo dnf install global

# macOS
brew install global

# Arch Linux
sudo pacman -S global

# 1. 初始化（使用 Ctags 作为后端解析器）
gtags --gtagslabel=ctags

# 生成的文件：
# GTAGS   — 定义数据库
# GRTAGS  — 引用数据库
# GPATH   — 路径数据库

# 2. 搜索定义
gtags -d main

# 3. 搜索引用
gtags -r main

# 4. 搜索文件
gtags -P main.c

# 5. 增量更新
global -u

# ~/.globalrc
# 使用 Universal Ctags 作为解析器
GTAGSLABEL=ctags

# 或者在项目目录中
# export GTAGSLABEL=ctags
# gtags

" 安装 vim-gtags 插件
Plug 'jsfaint/gen_tags.vim'

" 或使用 vim-gutentags 的 gtags 支持
let g:gutentags_modules = ['ctags', 'gtags_cscope']

" 智能跳转函数：先尝试 LSP，再 fallback 到 Ctags
function! SmartGoToDefinition()
    " 检查是否有活跃的 LSP 客户端
    if exists('*luaeval') && luaeval('not vim.tbl_isempty(vim.lsp.buf_get_clients(0))')
        lua vim.lsp.buf.definition()
    else
        " fallback 到 Ctags
        try
            tag <C-R><C-W>
        catch
            echohl ErrorMsg
            echo "Tag not found: " . expand("<cword>")
            echohl None
        endtry
    endif
endfunction

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

" 智能预览
function! SmartPreview()
    if exists('*luaeval') && luaeval('not vim.tbl_isempty(vim.lsp.buf_get_clients(0))')
        lua vim.lsp.buf.hover()
    else
        try
            ptag <C-R><C-W>
        catch
            echohl ErrorMsg
            echo "Tag not found: " . expand("<cword>")
            echohl None
        endtry
    endif
endfunction

nnoremap K :call SmartPreview()<CR>

" vim-lsp 配置
Plug 'prabirshrestha/vim-lsp'
Plug 'prabirshrestha/asyncomplete.vim'
Plug 'prabirshrestha/asyncomplete-lsp.vim'

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

" LSP 用于精确跳转和补全
" Ctags 用于全局搜索和预览

" coc.nvim（推荐）
Plug 'neoclide/coc.nvim', {'branch': 'release'}
Plug 'ludovicchabant/vim-gutentags'

" coc-settings.json 配置
" {
"   "coc.preferences.formatOnSave": true,
"   "suggest.noselect": false,
"   "diagnostic.enable": true
" }

#!/bin/bash
# ctags-search.sh - Ctags 符号搜索服务

TAGS_FILE="tags"

search() {
    local query="$1"
    local kind="$2"

    if [ -n "$kind" ]; then
        grep "^${query}.*${kind}" "$TAGS_FILE" | head -20
    else
        grep "^${query}" "$TAGS_FILE" | head -20
    fi
}

list_functions() {
    awk -F'\t' '/"\tf/ {print $1}' "$TAGS_FILE" | sort | uniq
}

list_classes() {
    awk -F'\t' '/"\tc/ {print $1}' "$TAGS_FILE" | sort | uniq
}

# 使用
case "$1" in
    search)  search "$2" "$3" ;;
    funcs)   list_functions ;;
    classes) list_classes ;;
    *)       echo "Usage: $0 {search|funcs|classes} [query]" ;;
esac

#!/bin/bash
# gen_doc_index.sh - 从 Ctags 生成项目文档索引

OUTPUT="API.md"
TAGS_FILE="tags"

echo "# 项目 API 索引" > "$OUTPUT"
echo "" >> "$OUTPUT"
echo "自动生成于 $(date)" >> "$OUTPUT"
echo "" >> "$OUTPUT"

# 函数列表
echo "## 函数" >> "$OUTPUT"
echo "" >> "$OUTPUT"
echo "| 函数名 | 文件 | 行号 | 签名 |" >> "$OUTPUT"
echo "|--------|------|------|------|" >> "$OUTPUT"

ctags --output-format=json --fields=+S+n -f - . | \
    jq -r 'select(.kind == "function") |
    "| \(.name) | \(.path) | \(.line // "?") | \(.signature // "()") |"' \
    >> "$OUTPUT"

# 类列表
echo "" >> "$OUTPUT"
echo "## 类" >> "$OUTPUT"
echo "" >> "$OUTPUT"
echo "| 类名 | 文件 | 行号 |" >> "$OUTPUT"
echo "|------|------|------|" >> "$OUTPUT"

ctags --output-format=json --fields=+n -f - . | \
    jq -r 'select(.kind == "class") |
    "| \(.name) | \(.path) | \(.line // "?") |"' \
    >> "$OUTPUT"

echo "Generated $OUTPUT"

#!/bin/bash
# ctags-rg.sh - 组合使用 Ctags 和 ripgrep

case "$1" in
    def)
        # 搜索符号定义
        grep "^$2" tags | head -10
        ;;
    ref)
        # 搜索符号引用（使用 ripgrep）
        rg --word-regexp "$2" -g '*.{c,h,cpp,hpp,py,js,ts}' | head -20
        ;;
    both)
        # 同时显示定义和引用
        echo "=== Definitions ==="
        grep "^$2" tags | head -5
        echo ""
        echo "=== References ==="
        rg --word-regexp "$2" -g '*.{c,h,cpp,hpp,py,js,ts}' | head -10
        ;;
    *)
        echo "Usage: $0 {def|ref|both} <symbol>"
        ;;
esac

# 安装 ag
sudo apt install silversearcher-ag

# 使用 ag 搜索代码
ag --c --cpp --python --js "function_name"

# 与 Ctags 结合
grep "^function_name" tags  # 定义
ag "function_name"          # 所有引用

# .github/workflows/ctags.yml
name: Generate Ctags Index

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  ctags:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v4

    - name: Install Universal Ctags
      run: |
        sudo apt update
        sudo apt install -y universal-ctags

    - name: Generate tags
      run: |
        ctags -R \
          --fields=+S+s+n \
          --extras=+q \
          --sort=yes \
          --output-format=json \
          -f tags.json .

    - name: Upload tags artifact
      uses: actions/upload-artifact@v4
      with:
        name: ctags-index
        path: tags.json

# .gitlab-ci.yml
stages:
  - index

ctags:
  stage: index
  image: ubuntu:latest
  before_script:
    - apt-get update && apt-get install -y universal-ctags
  script:
    - ctags -R --fields=+S+s+n --sort=yes .
    - wc -l tags
  artifacts:
    paths:
      - tags
    expire_in: 1 week

# Dockerfile.ctags - Ctags 工具容器
FROM ubuntu:22.04

RUN apt-get update && \
    apt-get install -y universal-ctags && \
    apt-get clean

WORKDIR /workspace

# 使用：
# docker build -f Dockerfile.ctags -t ctags-tool .
# docker run -v $(pwd):/workspace ctags-tool ctags -R .

# 1. 使用 Ctags 快速定位
grep "^my_function" tags

# 2. 使用 clang-tidy 进行静态分析
clang-tidy src/file.c -- -I include/

# 结合使用：
# Ctags 找到文件和行号，clang-tidy 进行深度分析

# Ctags 用于快速符号查找
# cppcheck 用于代码质量检查

ctags -R .
cppcheck --enable=all src/