如何为GEDCOM/ADIF等纯文本文件设计自动补全、语法高亮等输入辅助工具

无需语言服务器的IDE语法高亮与自动补全方案 #

不用搭建语言服务器，依托IDE原生功能就能实现需求，比零散正则更易维护：

• IDE语法定义文件：VS Code用.tmLanguage.json，Vim用syntax脚本，这类文件可以按格式的结构化规则（比如GEDCOM的层级标签、ADIF的键值结构）定义匹配逻辑，能精准识别合法关键词、值类型，实现语法高亮。比如GEDCOM的HEAD NAME标签、ADIF的CALL QSO_DATE字段，直接在语法文件里枚举或按规则匹配，比单正则的扩展性强很多。
• 自定义代码片段：针对高频使用的固定结构，预定义代码片段。比如输入ged-head自动补全GEDCOM的头部模板，输入adif-qso插入完整的ADIF QSO条目，还能设置占位符提示输入内容，补全效率直接拉满。
• 导入合法词汇表：把格式的所有合法关键词（比如GEDCOM全标签、ADIF全字段名）导入IDE的用户词汇表，IDE会自动识别这些词汇，输入时给出补全建议，还能标记拼写错误，比正则做拼写检查更直接。

简化纯文本录入的示例 #

示例1：ADIF格式的CLI检查+格式化工具 #

用Python写轻量脚本adif-lint.py，实现类似flake8的检查和Black的格式化：

import re
import sys

def validate_adif(content):
    errors = []
    # 检查必填字段
    required_fields = ["CALL", "QSO_DATE", "TIME_ON"]
    for field in required_fields:
        if f"<{field}:" not in content:
            errors.append(f"缺失必填字段: {field}")
    # 检查日期格式（必须是8位数字）
    date_matches = re.findall(r"<QSO_DATE:(\d+)>(\d+)", content)
    for length, value in date_matches:
        if length != "8" or not value.isdigit():
            errors.append(f"QSO_DATE格式错误: {value} 需为8位数字")
    return errors

def format_adif(content):
    # 统一字段缩进，让格式更规整
    lines = content.split("\n")
    formatted = []
    for line in lines:
        if line.startswith("<"):
            formatted.append(f"  {line.strip()}")
        else:
            formatted.append(line.strip())
    return "\n".join(formatted)

if __name__ == "__main__":
    if len(sys.argv) < 2:
        print("用法: python adif-lint.py <adif文件路径>")
        sys.exit(1)
    
    with open(sys.argv[1], "r") as f:
        content = f.read()
    
    # 先执行检查
    errors = validate_adif(content)
    if errors:
        print("检查发现错误:")
        for err in errors:
            print(f"- {err}")
        sys.exit(1)
    
    # 格式化并覆盖原文件
    formatted_content = format_adif(content)
    with open(sys.argv[1], "w") as f:
        f.write(formatted_content)
    print("文件已通过检查并完成格式化")

用法：直接在终端运行python adif-lint.py my_qso.adif，自动校验必填项和格式，同时统一缩进。

示例2：VS Code中ADIF的语法高亮+快速补全 #

1. 语法高亮配置：创建adif.tmLanguage.json文件，定义字段和值的高亮规则：

{
  "name": "ADIF",
  "scopeName": "source.adif",
  "patterns": [
    {
      "name": "keyword.control.adif",
      "match": "<([A-Z0-9_]+):\\d+>"
    },
    {
      "name": "string.quoted.double.adif",
      "match": ">([^<]+)"
    }
  ]
}

将该文件放到VS Code的用户扩展目录，ADIF文件的字段名会高亮为关键词，值高亮为字符串。
2. 快速补全配置：创建snippets/adif.json：

{
  "ADIF标准QSO条目": {
    "prefix": "adif-qso",
    "body": [
      "<CALL:${1:CALLSIGN}>",
      "<QSO_DATE:8>${2:YYYYMMDD}",
      "<TIME_ON:4>${3:HHMM}",
      "<BAND:${4:3}>20m",
      "<MODE:${5:3}>CW"
    ],
    "description": "快速插入ADIF QSO记录模板"
  }
}

在ADIF文件中输入adif-qso，按Tab就能插入完整模板，再通过Tab切换占位符填写内容。

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