使用UnityGameFramework日常记录_3_配一键转换配置表

该系列只做记录 不做教程 所以文章简洁直接 会列出碰到的问题和解决方案 只适合UGF萌新

为了提高效率，我使用Python编写了一个脚本，实现了一键将Excel表格批量转换为带分隔符的Txt文件，并支持打包为.exe文件，方便非技术人员使用。

---

---

前言

在游戏开发过程中，配置表是必不可少的一部分。尤其是在使用UGF（Unity Game Framework）进行游戏框架搭建时，数据驱动尤为重要。我们经常需要将策划配置好的Excel表格转换为游戏运行时所需的文本格式（如.txt、.csv、.json等）。

---

提示：以下是本篇文章正文内容，下面案例可供参考

一、安装环境

1.安装Python

Python官网链接: Python官网

1.安装PyCharm

PyCharm官网链接: PyCharm官网

二、开始创建Python项目

1.创建Python项目

2.敲代码

import os
import pandas as pd

# === 设置输入输出文件夹路径 ===
input_folder = r'F:\001_PythonProjects\000_PeiZhiBiao\PeiZhiBiao\PeiZhiBiao'  # 这里替换为你的输入文件夹路径
output_folder = r'F:\001_PythonProjects\000_PeiZhiBiao\PeiZhiBiao\ShuChuBiao'  # 这里替换为你的输出文件夹路径

# 如果输出文件夹不存在，则创建它
os.makedirs(output_folder, exist_ok=True)

# === 遍历输入文件夹中的所有 .xlsx 文件 ===
for file_name in os.listdir(input_folder):
    if file_name.endswith('.xlsx'):
        xlsx_path = os.path.join(input_folder, file_name)

        # 读取第一个 sheet
        df = pd.read_excel(xlsx_path, sheet_name=0)

        # 构造输出 txt 文件路径（同名，后缀改为 .txt）
        txt_file_name = os.path.splitext(file_name)[0] + '.txt'
        txt_path = os.path.join(output_folder, txt_file_name)

        # 将数据写入 txt 文件，使用 UTF-8-BOM 编码，制表符分隔
        df.to_csv(txt_path, sep='\t', index=False, encoding='utf-8-sig')

        print(f"转换完成：{file_name} → {txt_file_name}")

2.导入安装依赖

在控制台导入依赖包

pip install pandas openpyxl

3.打开命令提示符，准备打包exe文件

1.按下键盘的 Win + R，输入 cmd，回车，打开命令行窗口

2.安装pyinstaller

pip install pyinstaller

3.使用 cd 命令切换目录

1.假设你的 Python 脚本 main.py 在这个文件夹：

F:\001_PythonProjects\000_PeiZhiBiao

2.使用 cd 命令切换目录

cd F:\001_PythonProjects\000_PeiZhiBiao

F:

3.开始打包

pyinstaller --onefile main.py

4.exe文件

5.双击main.exe 就能进行一键配置表转换了

总结

新手的话估计会遇到很多问题，主要是在安装python和PyCharm上，特别是配置python的环境变量的时候，这块内容网上教程很多，B站也有很多视频，可以多学习一下~