手里有一段写得不错的Python计时器逻辑，跑在命令行里一切正常，现在想把它放到Django项目里做成网页版，应该怎么动手？这是不少学习Django的朋友都会遇到的问题。核心思路其实很简单：Django本质上也是一个Python程序，你的独立逻辑不需要重写，只需要做好分层和封装，让它能够被视图调用即可。下面用一个完整的计时器例子，把整个集成过程拆开讲清楚。
一、先看看独立的Python计时器逻辑长什么样
假设我们原本有一个独立的计时器脚本，功能是倒计时指定秒数，结束后给出提示。代码可能是这样的：
import time
def countdown(seconds):
"""简单的倒计时函数"""
for remaining in range(seconds, 0, -1):
print(f"剩余时间：{remaining} 秒")
time.sleep(1)
print("时间到！")
if __name__ == "__main__":
countdown(60)
这段代码在命令行里没有问题，但直接搬进Django是行不通的。原因有两个：第一，它用了time.sleep()做阻塞等待，如果在Django视图里调用，整个请求会被卡住几十秒，用户浏览器一直转圈，超时后还会报错；第二，它用print输出结果，而Web场景下输出应该体现在HTTP响应里。
所以在集成之前，需要先理解一个原则：Web应用是请求-响应模型，一次请求必须尽快返回。计时这类需要持续状态的功能，应该把开始时间和剩余量保存下来，每次请求时计算当前状态，而不是在服务器上真的睡上一分钟等时间流逝。
二、封装核心逻辑为可复用的模块
集成前先把纯逻辑从脚本中剥离出来，放到Django应用的专属模块里。假设应用名叫timer，在timer/目录下新建一个core.py，把与界面无关的计算逻辑集中在这里：
from datetime import datetime, timedelta
class Timer:
"""无界面的计时器核心类，负责状态计算"""
def __init__(self, total_seconds):
self.total_seconds = total_seconds
self.started_at = None
def start(self):
self.started_at = datetime.now()
return self
def remaining(self):
"""计算剩余秒数，不需要sleep"""
if self.started_at is None:
return self.total_seconds
elapsed = (datetime.now() - self.started_at).total_seconds()
left = self.total_seconds - elapsed
return max(0, int(left))
def is_finished(self):
return self.remaining() <= 0
注意这里的改动思路：把sleep循环换成了基于时间戳的计算。start()记录开始时刻，remaining()每次被调用时用当前时间减去开始时间得出剩余量。这样任何一次HTTP请求进来，都能立刻算出计时器的实时状态，服务器完全不需要等待。
这种封装还有一个好处：核心类不依赖Django的任何组件，将来想迁移到Flask或者命令行，直接拿走就能用。保持逻辑层和框架层解耦，是集成独立Python代码时最值得坚持的习惯。
三、在视图中调用逻辑并用会话保存状态
接下来写视图。计时器需要在多次请求之间记住开始时间，最简单的方案是使用Django的session，把必要的状态存在服务器端，浏览器通过cookie关联。在timer/views.py中：
from django.shortcuts import render, redirect
from django.utils import timezone
from .core import Timer
def set_timer(request):
if request.method == "POST":
minutes = int(request.POST.get("minutes", 1))
t = Timer(minutes * 60).start()
# 只把可序列化的基本数据存入session
request.session["timer_total"] = t.total_seconds
request.session["timer_started"] = t.started_at.timestamp()
return redirect("timer_status")
return render(request, "timer/set.html")
def timer_status(request):
total = request.session.get("timer_total")
if total is None:
return redirect("timer_set")
started = request.session.get("timer_started")
t = Timer(total)
t.started_at = datetime.fromtimestamp(started)
context = {
"remaining": t.remaining(),
"finished": t.is_finished(),
"total": total,
}
return render(request, "timer/status.html", context)
这里有个容易踩的坑要提醒一下：session中不能直接存Timer对象。Django默认的session后端只支持JSON可序列化的基本类型，往里面塞自定义类实例会直接报序列化错误。所以代码里只存了总秒数和开始时间戳两个数字，每次请求时用它们重新构造Timer实例。这个思路对任何带状态的功能都适用：持久化时存数据，使用时再还原成对象。
另外注意timer_status视图没有做任何等待操作，它只是查询状态然后立刻返回。如果希望页面上倒计时数字实时跳动，正确的做法是用JavaScript每秒请求一次接口，或者干脆在模板里输出初始剩余秒数，由前端脚本自己递减显示，把压力留给浏览器而不是服务器。
四、配置路由、模板与前端刷新
路由配置很常规，在应用目录的urls.py里注册两个视图：
from django.urls import path
from . import views
urlpatterns = [
path("set/", views.set_timer, name="timer_set"),
path("status/", views.timer_status, name="timer_status"),
]
然后是模板。设置页提供一个简单的表单让用户输入分钟数，状态页展示剩余时间。状态页可以配合一点前端脚本实现秒级的动态显示：
<h2>剩余时间：<span id="clock">{{ remaining }}</span> 秒</h2>
{% if finished %}
<p>时间到！</p>
{% else %}
<p>总时长 {{ total }} 秒</p>
{% endif %}
<script>
let left = {{ remaining }};
setInterval(function() {
if (left > 0) { left = left - 1; }
document.getElementById("clock").textContent = left;
}, 1000);
</script>
这样服务器只负责提供初始状态和判断是否结束，秒针跳动完全由浏览器完成，既流畅又不占服务器资源。如果你的场景要求结束时必须由服务器触发动作（比如写数据库、发通知），可以再加一个接口让前端在剩余为零时回调，或者使用Celery这类任务队列做后台调度。
最后别忘了一处细节：如果直接在项目的settings.py中把timer应用加进INSTALLED_APPS后报循环导入错误，多半是因为在core.py里反过来导入了views或models。逻辑模块保持单向依赖，views可以import core，core绝不import views，这条规矩守住了，集成过程会顺利很多。
五、总结迁移的通用步骤
回头看整个流程，把独立Python逻辑集成到Django大致遵循四步：剥离纯逻辑并去掉阻塞调用，封装成不依赖框架的模块；选择合适的状态保存方式（session、数据库或缓存），只存可序列化的数据；编写视图调用该模块，快速返回计算结果；用模板和前端脚本负责展示与交互。计时器只是一个具体例子，爬虫脚本、数据处理脚本、算法演示程序，都可以按同样的骨架搬进Django。理解了请求-响应模型和逻辑分层的思想，任何命令行Python程序都能比较自然地进化成一个Web应用。