Excel 批量编辑器

跨平台桌面应用（Mac/Windows），支持上传 Excel 模板、标记可替换字段，批量生成填充好的输出文件。

开发环境

前置条件

• Node.js 18+
• Python 3.9+（或 3.11+ 更佳）

安装依赖

npm install
cd /path/to/excel-batch-editor && source python/.venv/bin/activate 2>/dev/null || python3 -m venv python/.venv && source python/.venv/bin/activate && pip install -r python/requirements.txt

或分步执行：

# Node.js 依赖
npm install

# Python 依赖
cd excel-batch-editor
python3 -m venv python/.venv
source python/.venv/bin/activate   # Windows: python\.venv\Scripts\activate
pip install -r python/requirements.txt

开发模式启动

export PYTHON_PATH=$(which python3)   # 或使用 venv：export PYTHON_PATH=$(pwd)/python/.venv/bin/python3
NODE_ENV=development npm run dev

应用将在 http://localhost:5173 启动渲染进程，Electron 窗口自动打开。

运行 Python 测试

source python/.venv/bin/activate
pytest tests/python/ -v

项目结构

excel-batch-editor/
├── electron/          # Electron 主进程
│   ├── main.js        # 入口
│   ├── preload.js     # IPC 桥接
│   ├── ipc/           # IPC handler
│   └── db/            # SQLite 操作
├── renderer/          # React 前端（Vite）
│   └── src/
│       ├── pages/     # 页面组件
│       └── components/ # 通用组件
├── python/            # Python Excel 处理
│   ├── main.py        # stdin/stdout 入口
│   ├── parser.py      # 模板解析
│   └── generator.py   # 批量生成
└── tests/             # 测试
    └── python/        # Python 单元测试

技术栈

• 桌面壳：Electron 28（跨平台）
• UI：React 18 + Vite + Tailwind CSS
• Excel 处理：Python 3 + openpyxl
• 本地存储：SQLite（better-sqlite3）