手把手教你搭建本地可定制档案报表软件 附完整实操步骤

一、前置环境准备（1分钟完成）

本次搭建全程使用免费工具，所有档案数据本地存储，符合保密要求，零代码基础也能完成。步骤如下：

1. 安装Python环境

直接下载官方稳定版安装包，链接：https://www.python.org/ftp/python/3.11.4/python-3.11.4-amd64.exe

打开安装包后，必须勾选「Add Python 3.11 to PATH」选项，这是90%新手卡壳的步骤，然后点击「Install Now」等待安装完成即可。

2. 安装依赖库

按下键盘「Win+R」组合键，在弹出的运行框输入cmd，回车打开命令提示符窗口，直接复制粘贴以下命令，回车执行：

``` pip install --upgrade pip && pip install openpyxl pandas ```

若出现网络错误导致安装失败，换用国内镜像命令重试：

``` pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple && pip install openpyxl pandas -i https://pypi.tuna.tsinghua.edu.cn/simple ```

二、项目文件配置（3分钟完成）

1. 创建项目文件夹

打开电脑D盘，新建一个文件夹，命名为档案报表，在该文件夹内新建3个文件，文件名分别为：config.ini、main.py、档案数据.xlsx。

2. 填写配置文件内容

打开新建的config.ini，直接复制粘贴以下内容，每一行都有注释，你可以根据自己的需求修改：

``` [base] 你的档案数据Excel文件名，默认不需要改 data_file = 档案数据.xlsx 生成的报表保存的文件名 output_file = 档案统计报表.xlsx 按哪个字段分组统计，必须和你的档案数据表头一致 group_by = 档案类型 要过滤哪一年存入的档案，填0表示统计所有年份 filter_year = 0 ```

3. 填写程序文件内容

打开新建的main.py，直接复制粘贴以下完整代码，不需要修改任何内容即可使用：

``` import configparser import pandas as pd 读取配置 config = configparser.ConfigParser() config.read('config.ini', encoding='utf-8') data_file = config.get('base', 'data_file') output_file = config.get('base', 'output_file') group_by = config.get('base', 'group_by') filter_year = config.getint('base', 'filter_year') 读取档案数据 df = pd.read_excel(data_file) df['存入日期'] = pd.to_datetime(df['存入日期'], errors='coerce') 按年份过滤 if filter_year != 0: df = df[df['存入日期'].dt.year == filter_year] 生成统计报表 report_df = df.groupby(group_by, dropna=False).agg( 档案总数量=('档案编号', 'count'), 最早存入日期=('存入日期', 'min'), 最新存入日期=('存入日期', 'max') ).reset_index() 导出报表 report_df.to_excel(output_file, index=False) print(f"报表生成成功！文件保存在当前目录下：{output_file}") ```

4. 导入你的档案数据

打开档案数据.xlsx，将你所有的档案数据粘贴到这里，格式要求：

• 第一行为表头，表头名称要和你配置文件中group_by的参数对应，如果你要按「部门」分组，把group_by改成「部门」即可
• 存入日期列必须为标准日期格式，或者yyyy-mm-dd格式的文本，否则年份过滤功能会失效
• 所有档案数据从第二行开始，不要留空行，不要合并表头单元格

三、运行生成报表与问题排查

1. 运行生成报表

重新打开命令提示符窗口（Win+R输入cmd回车），复制粘贴以下命令，回车执行，切换到项目目录：

``` cd /d D:\档案报表 ```

然后执行以下命令生成报表：

``` python main.py ```

如果命令行输出「报表生成成功」，打开D盘的「档案报表」文件夹，就能看到生成好的档案统计报表.xlsx，可以直接编辑、排序或者批量打印。

2. 常见问题排查

• 提示「'python' 不是内部或外部命令」：安装Python时没有勾选PATH选项，卸载Python重新安装，一定要勾选「Add Python to PATH」
• 提示「No module named xxx」：回到前置准备步骤重新执行pip安装依赖的命令，安装完成后重试
• 生成的报表为空：检查filter_year配置是否正确，确认你的档案数据中存在对应年份的记录，检查表头名称是否和配置一致
• 提示「FileNotFoundError」：确认三个文件都放在D盘的「档案报表」文件夹内，检查文件名是否正确，关闭所有打开的文件后再运行程序

四、自定义功能扩展

如果需要添加其他统计需求，比如按多个字段分组、添加保管期限统计、统计不同密级的档案数量，只需要修改代码中report_df = df.groupby(...)部分的参数即可，比如添加保管期限统计只需要在agg中增加一行平均保管期限=('保管期限', 'mean')即可。

如果需要生成Web版本的局域网在线档案查询报表，可以扩展添加Flask路由，直接在本地局域网内访问，所有数据仍保存在本地服务器，完全符合档案管理的保密要求，不需要上传数据到第三方平台。