# 使用 verbose 模式查看配置文件加载情况
ctags -R --verbose=yes . 2>&1 | grep -i "option\|config\|ctags"

# 检查是否有项目级配置
ls -la .ctags .ctags.d/ 2>/dev/null

# 创建用户配置文件
cat > ~/.ctags << 'EOF'
# 用户级 Ctags 配置
# 以 # 开头的行为注释

# 默认排序标签文件
--sort=yes

# 默认输出字段
--fields=+S

# 排除常见的第三方目录
--exclude=.git
--exclude=.svn
--exclude=.hg
--exclude=node_modules
--exclude=bower_components
--exclude=.venv
--exclude=venv
--exclude=__pycache__
--exclude=.tox
--exclude=vendor
--exclude=dist
--exclude=build
--exclude=.idea
--exclude=.vscode
--exclude=.cache

# 默认启用的额外选项
--extras=+q
EOF

# 推荐使用 XDG 配置目录
mkdir -p ~/.config/ctags

# 通用默认配置
cat > ~/.config/ctags/default.ctags << 'EOF'
--sort=yes
--fields=+S
--extras=+q
--exclude=.git
--exclude=node_modules
--exclude=__pycache__
--exclude=.venv
--exclude=vendor
--exclude=build
--exclude=dist
EOF

# 语言特定配置（可选）
cat > ~/.config/ctags/c-lang.ctags << 'EOF'
# C 语言特定配置
--kinds-C=+def+l+h+x
--fields-C=+S
EOF

cat > ~/.config/ctags/python.ctags << 'EOF'
# Python 特定配置
--kinds-Python=+i
--fields-Python=+{defval}
--map-Python=+.wsgi
EOF

# 在项目根目录创建
cat > .ctags << 'EOF'
# 项目级 Ctags 配置
--languages=Python,JavaScript,TypeScript
--kinds-Python=+i
--exclude=node_modules
--exclude=.next
--exclude=coverage
--fields=+S
EOF

mkdir -p .ctags.d

# 通用项目配置
cat > .ctags.d/project.ctags << 'EOF'
# 此项目的 Ctags 配置
--sort=yes
--fields=+S
--extras=+q

# 项目特定排除
--exclude=.next
--exclude=out
--exclude=.turbo

# 项目使用的语言
--languages=TypeScript,JavaScript,Python,CSS,HTML
EOF

# 可选：特定子目录配置
cat > .ctags.d/backend.ctags << 'EOF'
# 后端专用配置（用于手动运行 ctags 时）
--languages=Python
--kinds-Python=+i+f+c+m
EOF

# 排除单个目录
--exclude=node_modules

# 排除多级目录（支持通配符）
--exclude='*/test/*'
--exclude='*/tests/*'

# 排除隐藏目录
--exclude='.*'

# 排除特定文件
--exclude=*.min.js
--exclude=*.bundle.js
--exclude=*.map

# 排除所有测试文件
--exclude='*_test.go'
--exclude='test_*.py'
--exclude='*.test.ts'
--exclude='*.spec.ts'

# 排除生成的文件
--exclude='*.pb.go'
--exclude='*_generated.py'

# 支持的通配符（基于 fnmatch）:
# *      匹配任意字符（不含 /）
# ?      匹配单个字符
# [...]  字符集
# **     匹配任意路径（含 /）

# 示例
--exclude='**/vendor/**'     # 任意层级的 vendor 目录
--exclude='*.generated.*'    # 生成的文件
--exclude='**/migrations/*'  # 数据库迁移文件

# 默认不索引二进制文件
# 但可以显式排除特定二进制扩展名
--exclude='*.o'
--exclude='*.so'
--exclude='*.dll'
--exclude='*.class'
--exclude='*.pyc'
--exclude='*.pyo'

# ===== Node.js 项目 =====
--exclude=node_modules
--exclude=bower_components
--exclude=.next
--exclude=.nuxt
--exclude=coverage
--exclude=.cache
--exclude=dist
--exclude=build

# ===== Python 项目 =====
--exclude=__pycache__
--exclude=.venv
--exclude=venv
--exclude=.tox
--exclude=.eggs
--exclude='*.egg-info'
--exclude=htmlcov
--exclude=.mypy_cache
--exclude=.pytest_cache

# ===== Go 项目 =====
--exclude=vendor
--exclude=.git

# ===== Java 项目 =====
--exclude=target
--exclude=.gradle
--exclude=build
--exclude='*.class'

# ===== C/C++ 项目 =====
--exclude=build
--exclude=out
--exclude='*.o'
--exclude='*.a'
--exclude='*.so'

# 排除所有隐藏目录
--exclude='.*'

# 但保留 .github 目录
--exclude-exception=.github

# 排除所有 build 目录
--exclude=build

# 但保留 build/include
--exclude-exception='build/include'

# 将 .inc 文件映射为 PHP
--map-PHP=+.inc

# 将 .thrift 文件映射为 Thrift（如果有）
--map-C=+.thrift

# 将 .h 文件映射到 C++ 而不是 C
--map-C=--.h
--map-C++=+.h

# 将 Vue 文件映射为 HTML（支持子语言解析）
--map-HTML=+.vue

# 将 .tsx 文件映射到 TypeScript
--map-TypeScript=+.tsx

# Dockerfile 映射
--map-Sh=+Dockerfile

# Makefile 变体
--map-Make=+makefile
--map-Make=+GNUmakefile
--map-Make=+Makefile.local

# 移除默认映射
--map-C=--.h        # .h 文件不再映射到 C

# 清除某个语言的所有扩展名映射
--map-Python=       # 清空 Python 的所有扩展名映射

# 按符号名字母排序（默认推荐）
--sort=yes

# 不排序（按文件顺序）
--sort=no

# 大小写折叠排序
--sort=foldcase

# 查看所有可用字段
ctags --list-fields

# 输出：
# N  name         on   NONE             s--    no    tag name
# F  file         on   NONE             s--    no    file name
# P  pattern      on   NONE             s--    no    pattern
# C  compact      off  NONE             s--    no    compact kind letter
# K  kind         on   NONE             s--    no    kind (long form)
# S  signature    on   NONE             s--    no    signature
# s  scope        off  NONE             s--    no    scope (kind-qualified)
# r  roles        off  NONE             s--    no    roles
# R  roles        off  NONE             s--    no    roles (canonicalized)
# Z  scopeKind    off  NONE             s--    no    scope kind
# E  extras       off  NONE             s--    no    extras
# x  xpath        off  NONE             s--    no    xpath
# p  kindPrefix   off  NONE             s--    no    kind letter prefix
# e  end          off  NONE             s--    no    end lines

# 启用签名字段
--fields=+S

# 启用作用域字段
--fields=+s

# 启用行号字段
--fields=+n

# 禁用模式字段
--fields=-P

# 组合使用
--fields=+S+s+n-r

# 启用所有字段
--fields='*'

# 推荐的默认字段配置
--fields=+S+s+n

# S  启用函数签名
# s  启用作用域
# n  启用行号

# 对补全友好的配置
--fields=+S+s+n+K+r

# K  使用长格式 kind
# r  包含角色信息

# 查看所有 extras
ctags --list-extras

# 常用 extras：
# q   qualified    启用完全限定名标签
# f   fileScope    文件局部符号
# p   pseudo       伪标签（文件头信息）
# g   guest        客座语言标签
# s   subparser    子解析器标签

# 启用限定名
--extras=+q

# 输出示例：
# MyClass           class.py    /^class MyClass:$/      c
# MyClass.__init__  class.py    /^    def __init__:/    m   class:MyClass
#                   ↑ 限定名（包含类名前缀）

# 禁用伪标签
--extras=-p

# 启用文件局部符号
--extras=+f

# 指定输入编码
--input-encoding=utf-8

# 指定输出编码
--output-encoding=utf-8

# 多编码支持
--input-encoding-utf8=utf-8
--input-encoding-gb=gbk

# 文件编码自动检测
--input-encoding=auto

# .ctags.d/00-default.ctags
--sort=yes
--fields=+S+s+n
--extras=+q
--input-encoding=utf-8

# .ctags.d/10-exclusions.ctags
--exclude=.git
--exclude=.svn
--exclude=node_modules
--exclude=bower_components
--exclude=.next
--exclude=.nuxt
--exclude=coverage
--exclude=.cache
--exclude=dist
--exclude=build
--exclude=out
--exclude=vendor
--exclude=.venv
--exclude=venv
--exclude=__pycache__
--exclude=.tox
--exclude=.mypy_cache
--exclude=.pytest_cache
--exclude='*.min.js'
--exclude='*.min.css'
--exclude='*.map'
--exclude='*.pyc'

# .ctags.d/20-languages.ctags
--languages=TypeScript,JavaScript,Python,CSS,HTML,SQL,Sh
--map-TypeScript=+.tsx
--map-HTML=+.vue
--map-HTML=+.jsx

# .ctags.d/30-kinds.ctags
--kinds-Python=+i
--kinds-JavaScript=+v
--kinds-TypeScript=+v
--kinds-C=+d+h

# .ctags.d/00-default.ctags
--sort=yes
--fields=+S+s+n
--extras=+q

# .ctags.d/10-exclusions.ctags
--exclude=.git
--exclude=build
--exclude=out
--exclude='*.o'
--exclude='*.a'
--exclude='*.so'
--exclude='*.d'

# .ctags.d/20-c.ctags
--languages=C,C++
--kinds-C=+d+e+f+g+h+l+m+n+p+s+t+u+v+x
--kinds-C++=+c+d+e+f+g+h+l+m+n+p+s+t+u+v+x
--fields-C++=+S+s+n+{template}

# 查看实际生效的配置
ctags --options=NONE -R . 2>&1 | head -5
# 使用 --options=NONE 忽略所有配置文件

# 对比有无配置的区别
diff <(ctags -f - --options=NONE src/) <(ctags -f - src/)

# 检查配置文件语法错误
ctags --options=.ctags -f /dev/null . 2>&1

# 查看配置文件加载顺序
ctags --verbose=yes -R . 2>&1 | grep -i "option"