FlClash配置文件是一个用于定义文件转换规则和选项的文件，通常以flclash.xml为名。以下是配置文件的主要结构和功能

版本信息

<version>5..</version>

指定FlClash工具的当前版本。

输入和输出设置

<source>
    <file>src/file.txt</file>
    <type>text</type>
</source>
<destination>
    <file>dest/file.xlsx</file>
    <type>excel</type>
</destination>

• source：定义输入文件的路径和类型（如text代表文本文件）。
• destination：定义输出文件的路径和类型（如excel代表Excel文件）。

转换规则

<conversionRules>
    <rule>
        <from>Text</from>
        <to>Excel</to>
        <columns>10</columns>
        <separator>\t</separator>
        <conversionOptions>
            <option>none</option>
            <option>preserve</option>
        </conversionOptions>
    </rule>
</conversionRules>

• from：输入文件的数据类型。
• to：输出文件的数据类型。
• columns：输出文件的列数。
• separator：字段分隔符，例如\t表示制表符。
• conversionOptions：转换选项，例如none表示不保留原格式，preserve表示保留原有格式。

转换规则详细说明

<rules>
    <rule>
        <name>日期格式转换</name>
        <type>expression</type>
        <expression>new Date($date)</expression>
        <from>date</from>
        <to>date</to>
    </rule>
</rules>

• name：规则的名称,便于管理和引用。
• type：规则类型，如expression表示使用表达式。
• expression：转换表达式，例如new Date($date)用于将日期字符串转换为日期对象。
• from：源数据类型。
• to：目标数据类型。

转换选项

<conversionOptions>
    <keepOriginalFormat>yes</keepOriginalFormat>
    <ignoreMissingValues>yes</ignoreMissingValues>
    <uppercase>no</uppercase>
    <encrypt>no</encrypt>
</conversionOptions>

• keepOriginalFormat：是否保留原始格式，yes表示保留。
• ignoreMissingValues：是否忽略缺失值，yes表示忽略。
• uppercase：是否将文本转换为大写，yes表示转换。
• encrypt：是否加密，yes表示加密。

高级选项

<advancedOptions>
    <exceptionHandling>strict</exceptionHandling>
    <logging>debug</logging>
    <customFunctions>
        <function>customFunction($param) { return $param + " - " + new Date().toISOString(); }</function>
    </customFunctions>
</advancedOptions>

• exceptionHandling：处理异常的方式，如strict表示严格处理。
• logging：日志级别，debug表示详细日志。
• customFunctions：自定义函数,用于自定义转换逻辑。

示例配置文件

<?xml version="1." encoding="UTF-8"?>
<FlClash>
    <version>5..</version>
    <source>
        <file>src/data.txt</file>
        <type>text</type>
    </source>
    <destination>
        <file>dest/output.xlsx</file>
        <type>excel</type>
    </destination>
    <conversionRules>
        <rule>
            <from>Text</from>
            <to>Excel</to>
            <columns>10</columns>
            <separator>\t</separator>
            <conversionOptions>
                <option>none</option>
                <option>preserve</option>
            </conversionOptions>
        </rule>
    </conversionRules>
    <rules>
        <rule>
            <name>日期格式转换</name>
            <type>expression</type>
            <expression>new Date($date)</expression>
            <from>date</from>
            <to>date</to>
        </rule>
    </rules>
    <conversionOptions>
        <keepOriginalFormat>yes</keepOriginalFormat>
        <ignoreMissingValues>yes</ignoreMissingValues>
        <uppercase>no</uppercase>
        <encrypt>no</encrypt>
    </conversionOptions>
    <advancedOptions>
        <exceptionHandling>strict</exceptionHandling>
        <logging>debug</logging>
        <customFunctions>
            <function>customFunction($param) { return $param + " - " + new Date().toISOString(); }</function>
        </customFunctions>
    </advancedOptions>
</FlClash>

使用说明

1. 文件路径：确保输入和输出文件路径正确无误。
2. 类型设置：确认输入和输出文件的类型是否正确。
3. 转换规则：定义或修改转换规则,特别是日期格式转换。
4. 选项设置：根据需求调整保留格式、处理缺失值、转换大小写和加密等选项。
5. 高级设置：如有特殊需求,可以添加自定义函数或异常处理。

示例转换

假设输入文件src/data.txt是一个文本文件,内容如下：

ID\tName\tDate
1\tJohn\t2023-10-10
2\tJane\t2023-10-11

配置文件如上所示，运行FlClash后，输出Excel文件dest/output.xlsx将包含以下数据：

• ID
• Name
• Date（日期格式）

验证和调试

在使用FlClash时，确保转换结果正确，可以通过查看输出文件或检查日志来验证转换是否正确，对于复杂转换，可以逐步添加规则并进行测试,确保每一步都正确无误。

通过以上配置，您可以灵活地管理FlClash的转换过程,满足不同的文件转换需求。