Gatan Script中高效读取JSON/INI配置文件的方法问询

1. 内置/第三方解析支持情况 #

Gatan Script（用于DigitalMicrograph）没有内置的INI或JSON解析函数，也没有官方维护的第三方库可直接调用。它的脚本环境相对封闭，核心API聚焦于显微图像处理，未提供通用配置文件解析工具。

2. 高效解析INI文件的最佳实践 #

既然逐行读取的方式繁琐，推荐封装一个轻量的INI解析函数，利用字符串分割、正则匹配简化逻辑，同时保证代码可维护性。以下是简洁健壮的实现示例：

示例代码：INI解析函数 #

// 解析INI文件，返回键值对字典
number ParseINI(string filePath, tagGroup &configOut)
{
    // 初始化输出配置组
    configOut = NewTagGroup()
    string currentSection = ""
    
    // 一次性读取所有行，比逐行读取更高效
    string lines[]
    if ( !ReadFileLines(filePath, lines) )
        return -1 // 文件读取失败
    
    // 正则匹配规则：匹配section行与键值行
    regex reSection = "\[(.+)\]"
    regex reKeyValue = "(.+?)\s*=\s*(.+)"
    
    for (number i=0; i<len(lines); i++)
    {
        string line = Trim(lines[i])
        if ( line == "" || line[0] == ';' || line[0] == '#' )
            continue // 跳过空行和注释
        
        // 匹配section块
        string sectionMatch[]
        if ( regex.match(reSection, line, sectionMatch) )
        {
            currentSection = sectionMatch[1]
            // 为当前section创建子配置组
            configOut.TagGroupCreateNewLabeledGroup(currentSection)
            continue
        }
        
        // 匹配键值对
        string kvMatch[]
        if ( regex.match(reKeyValue, line, kvMatch) && currentSection != "" )
        {
            string key = Trim(kvMatch[1])
            string valueStr = Trim(kvMatch[2])
            
            // 自动转换值类型：布尔、数字、字符串
            number valueNum
            if ( valueStr == "True" || valueStr == "true" )
                configOut.TagGroupSetTagAsBoolean(currentSection + ":" + key, True)
            else if ( valueStr == "False" || valueStr == "false" )
                configOut.TagGroupSetTagAsBoolean(currentSection + ":" + key, False)
            else if ( valueStr.scan("%g", valueNum) )
                configOut.TagGroupSetTagAsNumber(currentSection + ":" + key, valueNum)
            else
                configOut.TagGroupSetTagAsString(currentSection + ":" + key, valueStr)
        }
    }
    return 0
}

// 使用示例
void main()
{
    tagGroup config
    if ( ParseINI("config.ini", config) == 0 )
    {
        // 获取配置值
        bool displayMag, displayScaleBar
        config.TagGroupGetTagAsBoolean("basic:display_mag", displayMag)
        config.TagGroupGetTagAsBoolean("basic:display_scalebar", displayScaleBar)
        
        // 此处添加UI配置代码
        Result("display_mag: " + (displayMag ? "True" : "False") + "\n")
        Result("display_scalebar: " + (displayScaleBar ? "True" : "False") + "\n")
    }
    else
    {
        Result("Failed to read config file.\n")
    }
}

实现说明 #

• 用ReadFileLines一次性读取所有行，减少IO调用次数，效率优于逐行读取
• 正则匹配快速识别section和键值对，避免冗余的字符串判断逻辑
• 自动适配值类型（布尔、数字、字符串），直接匹配UI控件的参数需求
• 封装为独立函数，可在多个场景复用，提升代码可维护性

若需支持JSON格式，可参考类似思路：一次性读取文件内容后，通过正则或字符串分割解析JSON结构，但INI格式更适配简单UI配置场景，实现成本更低。

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