# BOMadder

**Repository Path**: sandman6z/bomadder

## Basic Information

- **Project Name**: BOMadder
- **Description**: 向已有BOM新增物料的工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-28
- **Last Updated**: 2025-10-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Excel中英文翻译工具

这是一个用于批量处理Excel文件的工具，可以将中文内容翻译为英文，特别针对BOM表格等工程文档进行了优化。

## 功能特点

- **批量处理**：同时处理一个文件夹下的所有Excel文件（.xlsx或.xls格式）
- **内容翻译**：将文件中的中文文本（包括单元格内容和工作表名称）翻译为英文
- **专业术语**：使用预定义的专业术语翻译表，确保准确性和一致性
- **自动输出**：将翻译后的文件保存到源文件夹内的transfer文件夹中
- **无需网络**：完全本地运行，不依赖任何在线翻译API
- **快速高效**：直接处理工作表结构，保持原有格式和内容完整性

## 支持的专业术语

工具内置了丰富的专业术语精确翻译，包括：
- 版本记录、产品名称、产品型号等文档标题
- 序号、位号、用量、元件名称等BOM表常用字段
- 贴片电容、肖特基二极管、发光二极管等电子元件名称

同时会自动删除常见的厂商名称后缀，如(三星)、(村田)、(国巨)等。

## 环境要求

- Python 3.7或更高版本（推荐3.10+）

## 安装步骤

1. 确保已安装Python
2. 打开命令提示符（CMD），导航到本工具所在目录
3. 安装依赖包：

```bash
pip install -r requirements.txt
```

## 使用方法

### 方法一：直接运行Python脚本
1. 将需要翻译的Excel文件复制到任意文件夹中
2. 使用命令提示符导航到该文件夹
3. 运行脚本（使用完整路径或复制脚本到当前目录）：

```bash
python excel_translator.py
```
4. 翻译完成后，结果文件将保存在当前目录下自动创建的`transfer`文件夹中

### 方法二：使用打包后的可执行文件
1. 将`excel_translator.exe`文件复制到包含Excel文件的文件夹中
2. 双击运行`excel_translator.exe`文件
3. 翻译完成后，结果文件将保存在当前目录下自动创建的`transfer`文件夹中

## 注意事项

- 程序会在**当前工作目录**中查找Excel文件，而不是脚本所在目录
- 对于大文件，处理时间可能会根据文件大小和内容复杂度有所不同
- 翻译结果保持原有Excel文件的所有格式和结构不变
- 自定义翻译表位于代码中的`CUSTOM_TRANSLATIONS`字典中，可根据需要进行扩展

## 故障排除

- 如果Excel文件无法打开，检查文件格式是否为.xlsx或.xls，且文件未被其他程序占用
- 如出现权限错误，确保有足够的文件读写权限
- 如果终端显示乱码，程序已内置Windows终端中文显示修复机制

## 定制化

如需添加新的专业术语翻译，请修改代码中的`CUSTOM_TRANSLATIONS`字典，按照`'中文术语': '英文翻译'`的格式添加新条目。