项目进度软件选型实战：5个维度对比Glovis与自建脚本

刚学完 Python 基础语法，对着屏幕发呆，不知道第一个项目该写什么？这是 80% 新手的共同困境。你掌握了 if-else 和循环，却不知如何把它们组装成能解决“项目进度管理”痛点的工具。今天不聊虚的，直接上完整示例，用代码拆解如何搭建一个轻量级的进度追踪系统。

作为曾在中小施工企业待过，又做过游戏开发的技术老兵，我深知“项目进度软件”这个词背后的复杂性。市面上的商业软件如 Microsoft Project、Glovis 功能强大但昂贵且封闭；而中小团队往往需要更灵活、成本更低的解决方案。本文将以“自建轻量级进度工具”为切入点，通过对比商业软件（以 Glovis 为例）与代码实现的差异，带你从环境搭建到核心逻辑，一步步跑通一个可用的原型。

概念速懂：为什么选择代码而非现成软件？

很多老板问：买个现成的项目进度软件不香吗？为什么非要自己写代码？

这里有一个关键的认知误区：现成软件解决的是“标准化流程”，而代码解决的是“个性化痛点”。以中小施工企业为例，我们的痛点往往不是“画甘特图”这个功能本身，而是“如何实时同步现场照片”、“如何自动计算关键路径延误预警”以及“如何与内部 ERP 数据打通”。

商业软件如 Glovis，其优势在于成熟的任务分解结构（WBS）模板和强大的报表引擎。但其劣势在于扩展性差，定制开发成本高，且数据封闭在云端或特定服务器中。相比之下，基于 Python 或 Go 语言自建的轻量级工具，虽然初期投入时间，但拥有完全的数据主权和逻辑控制权。

从游戏开发视角看，项目进度管理本质是一个“状态机”问题。每个任务都有“未开始”、“进行中”、“已完成”、“阻塞”等状态。商业软件封装好了这个状态机，而我们需要的是理解并重构这个状态机，使其适应我们的业务逻辑。

环境准备：打造极简开发链路

工欲善其事，必先利其器。我们要搭建的不仅仅是一个脚本，而是一个可维护的小型系统。

语言选择：推荐 Python 3.9+。理由是其生态丰富，pandas 处理数据，fastapi 提供接口，sqlite 做本地存储，全套工具链在单机即可运行，无需复杂的后端部署。

依赖管理：使用 venv 创建虚拟环境，避免依赖冲突。

python -m venv proj_env
source proj_env/bin/activate  # Linux/Mac
# 或 proj_env\Scripts\activate  # Windows
pip install fastapi uvicorn pandas sqlite3

目录结构：

project_tracker/
├── main.py          # 入口文件
├── models.py        # 数据模型定义
├── db.py            # 数据库操作
├── requirements.txt # 依赖清单
└── data/└── tracker.db   # SQLite数据库文件

这种结构参考了 FastAPI 官方开发者文档推荐的模块化设计原则，确保代码清晰、可测试。对于刚入门的开发者，保持文件数量在 5 个以内，能有效降低认知负担。

核心语法：构建任务状态机

在写完整代码前，我们需要理解核心逻辑。项目进度管理的核心是“任务”与“依赖关系”。

数据模型设计：一个任务（Task）至少包含以下字段：

id: 唯一标识
name: 任务名称
status: 状态（pending, in_progress, blocked, done）
start_date: 计划开始时间
end_date: 计划结束时间
progress_pct: 当前进度百分比（0-100）
dependencies: 前置任务 ID 列表

这里有一个常见的坑：日期处理。在 Python 中，建议使用 datetime 模块而非字符串存储日期，以便进行时间差计算和排序。

状态流转逻辑：任务状态不是随意变更的。例如，一个 blocked（阻塞）的任务不能直接变为 done（完成），必须先解除阻塞变为 in_progress。我们需要在代码中硬编码这些规则，防止数据污染。

完整代码示例：可运行的进度追踪原型

下面提供两段核心代码，分别负责数据持久化和 API 接口。你可以直接复制运行。

1. 数据库与模型层 (models.py & db.py)

这段代码定义了数据结构，并实现了 SQLite 的增删改查。注意注释中对关键行的说明。

import sqlite3
from datetime import datetime
from typing import List, Dict, Optional# 定义任务状态枚举，避免魔法字符串
STATUS_PENDING = 'pending'
STATUS_IN_PROGRESS = 'in_progress'
STATUS_BLOCKED = 'blocked'
STATUS_DONE = 'done'class TaskManager:def __init__(self, db_path: str = 'data/tracker.db'):self.db_path = db_pathself.init_db()def init_db(self):"""初始化数据库表结构"""with sqlite3.connect(self.db_path) as conn:cursor = conn.cursor()# 创建任务表，注意使用 ISO 格式存储日期字符串cursor.execute('''CREATE TABLE IF NOT EXISTS tasks (id INTEGER PRIMARY KEY AUTOINCREMENT,name TEXT NOT NULL,status TEXT NOT NULL DEFAULT 'pending',start_date TEXT,end_date TEXT,progress_pct INTEGER DEFAULT 0,dependencies TEXT DEFAULT '[]')''')conn.commit()def add_task(self, name: str, start_date: str, end_date: str, deps: List[int] = []):"""添加新任务，deps为前置任务ID列表"""with sqlite3.connect(self.db_path) as conn:cursor = conn.cursor()# 将依赖列表序列化为JSON字符串存储deps_str = str(deps).replace("'", '"')cursor.execute('''INSERT INTO tasks (name, start_date, end_date, dependencies)VALUES (?, ?, ?, ?)''', (name, start_date, end_date, deps_str))conn.commit()return cursor.lastrowiddef get_overdue_tasks(self) -> List[Dict]:"""获取所有已逾期且未完成的任务，这是进度管理的核心痛点"""today_str = datetime.now().strftime('%Y-%m-%d')with sqlite3.connect(self.db_path) as conn:cursor = conn.cursor()# SQL查询：结束日期早于今天，且状态不是完成cursor.execute('''SELECT id, name, end_date, progress_pctFROM tasksWHERE end_date < ? AND status != 'done'ORDER BY end_date ASC''', (today_str,))rows = cursor.fetchall()return [{'id': row[0],'name': row[1],'end_date': row[2],'progress_pct': row[3]} for row in rows]

2. API 接口层 (main.py)

使用 FastAPI 暴露接口，方便前端或脚本调用。

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel
from models import TaskManager
from typing import List, Optionalapp = FastAPI(title="Lightweight Project Tracker")
manager = TaskManager()class TaskCreate(BaseModel):name: strstart_date: strend_date: strdependencies: List[int] = []class TaskUpdate(BaseModel):status: Optional[str] = Noneprogress_pct: Optional[int] = None@app.post("/tasks")
def create_task(task: TaskCreate):"""创建任务接口"""task_id = manager.add_task(name=task.name,start_date=task.start_date,end_date=task.end_date,deps=task.dependencies)return {"id": task_id, "message": "Task created"}@app.get("/tasks/overdue")
def get_overdue():"""获取逾期任务列表，用于每日站会汇报"""overdue = manager.get_overdue_tasks()if not overdue:return {"message": "No overdue tasks", "count": 0}return {"tasks": overdue, "count": len(overdue)}@app.put("/tasks/{task_id}")
def update_task(task_id: int, update: TaskUpdate):"""更新任务状态或进度"""# 此处省略具体的SQL更新逻辑，需根据update字段动态生成SQL# 实际生产中需加入状态流转校验return {"id": task_id, "message": "Updated"}

运行方式：在终端执行 uvicorn main:app --reload，访问 http://127.0.0.1:8000/docs 即可看到自动生成的 Swagger 文档，直接在线测试接口。

常见报错与避坑指南

在实战中，以下三个错误出现频率最高：

日期格式不一致导致比较失败：
- 现象：SQL 查询返回空，明明有逾期任务。
- 原因：数据库中存储的是 2023-10-01，而代码传入的是 2023-10-01 12:00:00。
- 解决：统一使用 strftime('%Y-%m-%d') 进行标准化处理，确保字符串格式严格一致。
依赖关系死循环：
- 现象：任务 A 依赖 B，B 依赖 A，系统无法计算关键路径。
- 解决：在 add_task 时增加校验逻辑，使用图论中的“拓扑排序”算法检测环。对于入门项目，可以先简单禁止“自己依赖自己”的情况。
并发写入锁冲突：
- 现象：多人同时更新进度，报错 database is locked。
- 解决：SQLite 适合单写多读场景。若并发高，需引入 PRAGMA busy_timeout = 5000 设置等待时间，或迁移至 PostgreSQL。