### 多语转换工具知识点详解
#### 工具概述
多语转换工具是一种用于将Excel文件中的多语言数据转换成JavaScript文件格式的实用程序。它主要用于前端开发领域，特别是那些需要支持多语言环境的Web应用项目。通过该工具，开发者可以轻松地管理和更新应用程序中的多语言内容。
#### 核心功能
- **Excel到JS文件转换**：能够将包含多语言字符串的Excel文件转换成符合特定格式要求的JavaScript文件。
- **灵活的参数配置**：用户可以通过命令行参数来指定输入文件、输出路径、模板文件等选项。
- **自定义模板支持**：支持Freemarker语法的模板文件，允许用户定制输出的JS文件结构与样式。
- **输出文件命名规则**：输出的JS文件名基于Excel首行的数据列名称。
#### 参数说明
- **-i (Input)**: 必须参数，用于指定输入的Excel文件路径。需要注意的是，该文件必须是Excel 2003格式。
- 示例：`-i d:\lang.xls`
- **-o (Output)**: 必须参数，用于指定输出的JavaScript文件目录。
- 示例：`-o d:\js`
- **-t (Template)**: 非必须参数，用于指定模版文件路径。如果未提供此参数，工具将使用内置的默认模版进行转换。
- 示例：`-t d:\lang.html`
#### 默认行为与路径解析
- 如果输入的参数路径不是绝对路径，则默认以程序当前执行路径为根目录进行解析。
- 如果未指定模版文件，则程序将自动调用内置的默认模版进行JS文件的生成。
#### 使用示例
1. **基本使用**：
- `convert -i d:\lang.xls -o d:\js`
- 输入文件：`d:\lang.xls`
- 输出目录：`d:\js`
2. **省略输出目录路径**：
- `convert -i d:\lang.xls -o js`
- 输入文件：`d:\lang.xls`
- 输出目录：当前路径下的`js`目录
3. **指定模版文件**：
- `convert -i d:\lang.xls -o js -t template.html`
- 输入文件：`d:\lang.xls`
- 输出目录：当前路径下的`js`目录
- 模版文件：`template.html`
4. **指定模版文件的完整路径**：
- `convert -i d:\lang.xls -o js -t c:\template.html`
- 输入文件：`d:\lang.xls`
- 输出目录：当前路径下的`js`目录
- 模版文件：`c:\template.html`
#### 输出文件命名规则
- 输出的JS文件名称基于Excel文件的第一行（即列标题行）。
- 示例：
- 如果Excel文件的第一行为“中文”、“繁体”、“English”，则输出的JS文件分别为“中文.js”、“繁体.js”、“English.js”。
- 若遵循React项目的命名规范，建议Excel文件的第一行为“zh-cn”、“zh-hk”、“en”，则输出的JS文件名称依次为“zh-cn.js”、“zh-hk.js”、“en.js”。
#### 运行结果示例
- 成功转换后，控制台会显示“Convert Successful”，表明转换过程已完成。
#### 总结
多语转换工具为前端开发者提供了一种高效且灵活的方式来处理多语言资源。通过简单的命令行参数配置，开发者可以快速地将Excel中的多语言内容转换成适应项目需求的JavaScript文件格式。此外，自定义模板的支持进一步增强了工具的灵活性，使得输出的JS文件能够更好地融入到不同的前端框架和技术栈中。
