每年獎(jiǎng)學(xué)金評(píng)定季各個(gè)學(xué)院的辦公室基本都要經(jīng)歷一場(chǎng)Excel表格帶來(lái)的災(zāi)難。幾百條證書(shū)記錄在多個(gè)文件里來(lái)回復(fù)制粘貼名字寫(xiě)法不統(tǒng)一、發(fā)證日期格式混亂、按條件統(tǒng)計(jì)時(shí)只能靠肉眼數(shù)行數(shù)。我去年幫一個(gè)學(xué)院做了這套基于Flask的學(xué)生榮譽(yù)證書(shū)管理系統(tǒng)用Python寫(xiě)成的輕量級(jí)Web應(yīng)用部署在本地就能跑徹底治好了這個(gè)老毛病。這套系統(tǒng)適合誰(shuí)用高校輔導(dǎo)員、院系教務(wù)老師、學(xué)生工作負(fù)責(zé)人以及所有想用Flask練手做web開(kāi)發(fā)的初學(xué)者。它能完成學(xué)生信息維護(hù)、榮譽(yù)證書(shū)錄入、多條件查詢、級(jí)別篩選、Excel導(dǎo)出、打印預(yù)覽這些核心功能。整個(gè)項(xiàng)目代碼量不大但一個(gè)小型管理系統(tǒng)該有的東西幾乎都覆蓋了而且完全本地部署數(shù)據(jù)不出辦公室不依賴任何外部服務(wù)。我做這類項(xiàng)目有一個(gè)原則先解決真實(shí)場(chǎng)景里的痛點(diǎn)再談技術(shù)選型。下面就把這套系統(tǒng)的完整實(shí)現(xiàn)思路、數(shù)據(jù)庫(kù)設(shè)計(jì)、核心代碼和部署過(guò)程中的坑都攤開(kāi)來(lái)講希望你能少走彎路。1. 為什么放著現(xiàn)成系統(tǒng)不用非要自己寫(xiě)一個(gè)市面上成熟的學(xué)生管理系統(tǒng)并不少但落到學(xué)院內(nèi)部管理榮譽(yù)證書(shū)這個(gè)具體場(chǎng)景時(shí)往往都不合適。要么是收費(fèi)的商業(yè)系統(tǒng)功能大到根本用不完要么部署在云端數(shù)據(jù)安全和管理責(zé)任都說(shuō)不清更多的其實(shí)是學(xué)工系統(tǒng)里附帶的一個(gè)模塊字段固定、無(wú)法自定義想按校級(jí)、省級(jí)篩選還得找開(kāi)發(fā)方提需求一等就是幾個(gè)月。Excel雖然大家都在用但多人協(xié)作、數(shù)據(jù)校驗(yàn)、按條件篩選這些事做起來(lái)非常痛苦。證書(shū)一多、年份一長(zhǎng)表格就失控了。還有人把數(shù)據(jù)存在微信聊天記錄里換個(gè)人就斷檔。我的需求其實(shí)非常樸素就六條單機(jī)或局域網(wǎng)內(nèi)直接運(yùn)行不要復(fù)雜的部署流程能錄學(xué)生、錄證書(shū)刪改要方便支持按姓名、學(xué)號(hào)、證書(shū)級(jí)別、年份組合查詢?cè)u(píng)獎(jiǎng)評(píng)優(yōu)時(shí)要能快速導(dǎo)出名單打印證書(shū)清單時(shí)頁(yè)面要好看、格式要整齊數(shù)據(jù)不能丟備份要簡(jiǎn)單選型時(shí)我沒(méi)怎么糾結(jié)直接定了Python Flask SQLite這套組合。原因很直接Flask足夠輕一個(gè)小項(xiàng)目幾十個(gè)路由寫(xiě)完不需要框架替你決定代碼結(jié)構(gòu)SQLite零配置數(shù)據(jù)庫(kù)就是一個(gè)本地文件備份時(shí)直接拷貝走人。這套組合對(duì)學(xué)院級(jí)的數(shù)據(jù)量——幾千名學(xué)生、上萬(wàn)條證書(shū)記錄——性能綽綽有余。我也對(duì)比過(guò)其他方案。Django功能全自帶Admin后臺(tái)和完整ORM但項(xiàng)目體積和學(xué)習(xí)曲線都偏重殺雞用牛刀。Node.js和PHP也能做不過(guò)對(duì)非計(jì)算機(jī)背景的維護(hù)者來(lái)說(shuō)Python的語(yǔ)法和生態(tài)更友好后面想改需求拉個(gè)懂Python的人來(lái)也更容易。Electron桌面應(yīng)用方案我也考慮過(guò)打包體積大而且本質(zhì)還是Web技術(shù)不如直接用瀏覽器訪問(wèn)來(lái)得輕量自然。這里必須說(shuō)一個(gè)核心判斷這套系統(tǒng)的最終用戶大概率不是程序員。輔導(dǎo)員、班主任不會(huì)敲命令行也不懂環(huán)境變量怎么配。所以所有設(shè)計(jì)都要圍繞非技術(shù)用戶也能操作來(lái)展開(kāi)——界面要直觀、操作要少、反饋要明確。這也直接影響了我后面寫(xiě)一鍵啟動(dòng)腳本、簡(jiǎn)化部署步驟的方式。2. 數(shù)據(jù)庫(kù)怎么設(shè)計(jì)才夠用又不返工很多初學(xué)Flask的人上手就寫(xiě)路由、寫(xiě)頁(yè)面數(shù)據(jù)庫(kù)設(shè)計(jì)拖到最后隨便弄這是典型的本末倒置。數(shù)據(jù)庫(kù)是整個(gè)系統(tǒng)的地基字段沒(méi)想清楚后面改表結(jié)構(gòu)會(huì)讓你改到懷疑人生。我在這套系統(tǒng)上第一步就是定表結(jié)構(gòu)前后用了兩個(gè)晚上反復(fù)推演才把表設(shè)計(jì)敲定。我最后的學(xué)生表設(shè)計(jì)如下字段類型說(shuō)明idINTEGER 主鍵自增IDstudent_noVARCHAR(20)學(xué)號(hào)唯一索引nameVARCHAR(50)姓名class_nameVARCHAR(50)班級(jí)majorVARCHAR(80)專業(yè)enrollment_yearINTEGER入學(xué)年份證書(shū)表設(shè)計(jì)如下字段類型說(shuō)明idINTEGER 主鍵自增IDstudent_idINTEGER 外鍵關(guān)聯(lián)學(xué)生表idcert_nameVARCHAR(120)證書(shū)名稱cert_levelVARCHAR(20)級(jí)別國(guó)家級(jí)/省級(jí)/市級(jí)/校級(jí)/院級(jí)/其他issue_dateDATE發(fā)證日期issuing_unitVARCHAR(120)發(fā)證單位cert_noVARCHAR(80)證書(shū)編號(hào)remarkTEXT備注這個(gè)設(shè)計(jì)有什么講究每一點(diǎn)都是我實(shí)際踩過(guò)坑之后換來(lái)的。學(xué)生和證書(shū)必須拆成兩張表。這是最基本的表結(jié)構(gòu)規(guī)范化。如果為了省事全塞進(jìn)一張表同一個(gè)學(xué)生有三張證書(shū)他的姓名學(xué)號(hào)就得重復(fù)三行將來(lái)改一次班級(jí)信息要同時(shí)改三行甚至更多漏改一處數(shù)據(jù)就矛盾了。拆開(kāi)后學(xué)生的公共信息只存一份證書(shū)通過(guò)student_id外鍵關(guān)聯(lián)這是關(guān)系型數(shù)據(jù)庫(kù)最經(jīng)典的建模思路。學(xué)號(hào)必須唯一。現(xiàn)實(shí)中哪怕學(xué)生重名學(xué)號(hào)也一定不同所以學(xué)號(hào)是比姓名可靠得多的身份標(biāo)識(shí)。在SQLAlchemy里給student_no加uniqueTrue錄入時(shí)重復(fù)會(huì)直接報(bào)錯(cuò)攔截。這個(gè)約束必須在數(shù)據(jù)庫(kù)層面做不能只靠應(yīng)用層判斷不然并發(fā)提交時(shí)很容易繞過(guò)檢查。級(jí)別字段用固定下拉框。評(píng)獎(jiǎng)評(píng)優(yōu)時(shí)按證書(shū)級(jí)別加權(quán)計(jì)分是剛需如果允許自由填寫(xiě)國(guó)家國(guó)家級(jí)國(guó)獎(jiǎng)三種寫(xiě)法都會(huì)出現(xiàn)在庫(kù)里統(tǒng)計(jì)時(shí)頭都大。我在表單里直接用下拉框限定幾個(gè)選項(xiàng)國(guó)家級(jí)、省級(jí)、市級(jí)、校級(jí)、院級(jí)、其他。寧可損失一點(diǎn)靈活性也要保住數(shù)據(jù)的干凈整齊。發(fā)證日期用DATE類型而不是字符串。SQLite對(duì)類型約束相對(duì)寬松但業(yè)務(wù)代碼里用日期類型能保證后續(xù)按年份篩選、按月排序時(shí)不翻車。前端表單用input typedate用戶直接在日歷控件里選后端統(tǒng)一格式化成標(biāo)準(zhǔn)日期字符串存儲(chǔ)。如果圖省事存成2024年3月這種字符串后面你想按年份分組統(tǒng)計(jì)就等著自己寫(xiě)解析邏輯吧。這套設(shè)計(jì)是夠用且不返工的平衡點(diǎn)。我沒(méi)有做單獨(dú)的權(quán)限表因?yàn)槭褂脠?chǎng)景就是辦公室局域網(wǎng)內(nèi)幾個(gè)人用信任度較高不需要角色體系。也沒(méi)有做證書(shū)圖片上傳因?yàn)榇蛴∽C書(shū)清單所需的文字信息已經(jīng)全覆蓋了。如果你要把系統(tǒng)放到全校范圍用那就必須加用戶表、登錄驗(yàn)證、操作日志和備份策略這是后話。3. Flask項(xiàng)目骨架與實(shí)踐目錄結(jié)構(gòu)、配置和啟動(dòng)這一節(jié)直接給你一套我驗(yàn)證過(guò)可直接復(fù)用的項(xiàng)目結(jié)構(gòu)照著搭就行。cert-system/ ├── app.py # Flask應(yīng)用入口所有路由 ├── models.py # SQLAlchemy模型定義 ├── requirements.txt # 依賴清單 ├── start.bat # Windows一鍵啟動(dòng)腳本 ├── certs.db # SQLite數(shù)據(jù)庫(kù)文件首次運(yùn)行自動(dòng)生成 ├── static/ │ ├── css/ │ │ ├── style.css │ │ └── print.css │ └── js/ │ └── main.js └── templates/ ├── base.html ├── index.html ├── students.html ├── student_form.html ├── certs.html ├── cert_form.html ├── cert_detail.html └── stats.html依賴清單精簡(jiǎn)到極致就三樣flask2.3.3 flask-sqlalchemy3.1.0 openpyxl3.1.2flask我鎖了2.3.3版本因?yàn)檫@是我長(zhǎng)期使用的穩(wěn)定版本插件兼容性都已經(jīng)驗(yàn)證過(guò)。openpyxl是后面Excel導(dǎo)出功能要用的先裝好。models.py里定義兩個(gè)模型代碼是這樣from flask_sqlalchemy import SQLAlchemy from datetime import datetime db SQLAlchemy() class Student(db.Model): __tablename__ students id db.Column(db.Integer, primary_keyTrue) student_no db.Column(db.String(20), uniqueTrue, nullableFalse, indexTrue) name db.Column(db.String(50), nullableFalse, indexTrue) class_name db.Column(db.String(50)) major db.Column(db.String(80)) enrollment_year db.Column(db.Integer) certificates db.relationship(Certificate, backrefstudent, lazydynamic) def __repr__(self): return fStudent {self.student_no} {self.name} class Certificate(db.Model): __tablename__ certificates id db.Column(db.Integer, primary_keyTrue) student_id db.Column(db.Integer, db.ForeignKey(students.id), nullableFalse, indexTrue) cert_name db.Column(db.String(120), nullableFalse) cert_level db.Column(db.String(20), nullableFalse) issue_date db.Column(db.Date) issuing_unit db.Column(db.String(120)) cert_no db.Column(db.String(80)) remark db.Column(db.Text) created_at db.Column(db.DateTime, defaultdatetime.now) def __repr__(self): return fCertificate {self.cert_name} {self.cert_level}這里有兩個(gè)容易忽略但很重要的點(diǎn)。一是db.relationship的backrefstudent這個(gè)反向引用讓我們能通過(guò)cert.student.name直接拿到學(xué)生的姓名省去手動(dòng)join查詢。二是indexTrue加在student_no、name、student_id這些常用作查詢條件的字段上數(shù)據(jù)量上來(lái)之后查詢性能會(huì)明顯更好——幾千條數(shù)據(jù)時(shí)感覺(jué)不到區(qū)別但養(yǎng)成良好的加索引習(xí)慣對(duì)任何規(guī)模的項(xiàng)目都有價(jià)值。app.py入口的初始化方式from flask import Flask, render_template, request, redirect, url_for, flash, send_file from models import db, Student, Certificate import io from datetime import datetime from openpyxl import Workbook from openpyxl.styles import Font from openpyxl.utils import get_column_letter app Flask(__name__) app.config[SECRET_KEY] please-change-me-to-a-random-string app.config[SQLALCHEMY_DATABASE_URI] sqlite:///certs.db app.config[SQLALCHEMY_TRACK_MODIFICATIONS] False app.config[SQLALCHEMY_ENGINE_OPTIONS] { connect_args: {timeout: 10} } db.init_app(app) with app.app_context(): db.create_all()db.create_all()必須放在app.app_context()里這是flask-sqlalchemy 3.x的標(biāo)準(zhǔn)初始化方式。老版本可以直接在模塊級(jí)別調(diào)用新版本就必須顯式創(chuàng)建應(yīng)用上下文這是初學(xué)者最容易踩的坑——運(yùn)行后一直報(bào)No such table排查半天才發(fā)現(xiàn)是因?yàn)閏reate_all()根本沒(méi)執(zhí)行。路由的寫(xiě)法遵循標(biāo)準(zhǔn)的CRUD模式。以證書(shū)錄入為例我貼一段完整代碼app.route(/certs/add, methods[GET, POST]) def add_cert(): if request.method POST: student_id request.form.get(student_id) cert_name request.form.get(cert_name) cert_level request.form.get(cert_level) issue_date_str request.form.get(issue_date) issuing_unit request.form.get(issuing_unit) cert_no request.form.get(cert_no) remark request.form.get(remark) if not student_id or not cert_name or not cert_level: flash(學(xué)生、證書(shū)名稱、級(jí)別為必填項(xiàng)) return redirect(url_for(add_cert)) issue_date None if issue_date_str: try: issue_date datetime.strptime(issue_date_str, %Y-%m-%d).date() except ValueError: flash(日期格式不正確) return redirect(url_for(add_cert)) cert Certificate( student_idint(student_id), cert_namecert_name, cert_levelcert_level, issue_dateissue_date, issuing_unitissuing_unit, cert_nocert_no, remarkremark ) db.session.add(cert) db.session.commit() flash(證書(shū)添加成功) return redirect(url_for(cert_list)) students Student.query.order_by(Student.student_no).all() return render_template(cert_form.html, studentsstudents)后端校驗(yàn)這段一定要寫(xiě)。雖然前端HTML里已經(jīng)加了required標(biāo)記但后端必須再校驗(yàn)一次——用戶不一定通過(guò)頁(yè)面提交直接構(gòu)造請(qǐng)求繞過(guò)前端校驗(yàn)的事太常見(jiàn)了。后端校驗(yàn)做得好不好直接影響數(shù)據(jù)質(zhì)量。日期處理是個(gè)隱蔽的坑。表單如果傳了空字符串datetime.strptime(, %Y-%m-%d)會(huì)直接拋異常所以我先判斷if issue_date_str再轉(zhuǎn)換。很多人一眼覺(jué)得這邏輯多余直到自己提交空日期時(shí)頁(yè)面直接500才反應(yīng)過(guò)來(lái)。這類細(xì)節(jié)就是開(kāi)發(fā)經(jīng)驗(yàn)值在起作用。證書(shū)列表頁(yè)的查詢我實(shí)現(xiàn)了三維度組合篩選app.route(/certs) def cert_list(): keyword request.args.get(keyword, ).strip() level request.args.get(level, ) year request.args.get(year, ) query Certificate.query.join(Student) if keyword: like f%{keyword}% query query.filter(db.or_( Student.name.like(like), Student.student_no.like(like), Certificate.cert_name.like(like) )) if level: query query.filter(Certificate.cert_level level) if year: query query.filter(db.extract(year, Certificate.issue_date) int(year)) certs query.order_by(Certificate.issue_date.desc()).all() total query.count() return render_template(certs.html, certscerts, totaltotal, keywordkeyword, levellevel, yearyear)db.or_把多個(gè)LIKE條件合并成一個(gè)邏輯或讓用戶輸入一個(gè)關(guān)鍵詞就能同時(shí)匹配學(xué)生姓名、學(xué)號(hào)或證書(shū)名稱。年份篩選用的db.extract(year, ...)是跨數(shù)據(jù)庫(kù)安全的標(biāo)準(zhǔn)寫(xiě)法不要在SQLite里用字符串拼接函數(shù)來(lái)做換個(gè)數(shù)據(jù)庫(kù)就失效了。開(kāi)發(fā)時(shí)我用的是VSCode Python插件配好virtualenv后F5就能啟動(dòng)調(diào)試非常順手。如果你是新手建議先花半小時(shí)把VSCode的Python環(huán)境配置調(diào)好再開(kāi)始動(dòng)手寫(xiě)代碼能省下后面大量排錯(cuò)時(shí)間。4. 前端頁(yè)面骨架與體驗(yàn)細(xì)節(jié)不需要前端框架也很能打這個(gè)系統(tǒng)的使用者是辦公室老師不是專業(yè)前端所以我的原則是界面簡(jiǎn)單、反饋清晰、操作最少。我選了Bootstrap 5的CDN來(lái)搭頁(yè)面框架沒(méi)有引入Vue、React或任何工程化工具。為什么不用前端框架因?yàn)檫@類內(nèi)部管理系統(tǒng)的核心是表單和表格全是服務(wù)端渲染的Jinja2模板就夠用了。你用Vue ElementUI當(dāng)然更強(qiáng)但項(xiàng)目復(fù)雜度會(huì)指數(shù)級(jí)上升——打包、路由、狀態(tài)管理、跨域每樣都要學(xué)最后你可能花了三天搭環(huán)境一天寫(xiě)業(yè)務(wù)性價(jià)比太低。base.html是模板繼承的根基我把它當(dāng)作全站的公共殼!DOCTYPE html html langzh-CN head meta charsetUTF-8 meta nameviewport contentwidthdevice-width, initial-scale1.0 title{% block title %}學(xué)生榮譽(yù)證書(shū)管理系統(tǒng){% endblock %}/title link hrefhttps://cdn.jsdelivr.net/npm/bootstrap5.3.0/dist/css/bootstrap.min.css relstylesheet link href{{ url_for(static, filenamecss/style.css) }} relstylesheet {% block head_extras %}{% endblock %} /head body nav classnavbar navbar-expand-lg navbar-dark bg-primary div classcontainer-fluid a classnavbar-brand href{{ url_for(index) }}榮譽(yù)證書(shū)管理系統(tǒng)/a div classnavbar-nav a classnav-link href{{ url_for(student_list) }}學(xué)生管理/a a classnav-link href{{ url_for(cert_list) }}證書(shū)管理/a a classnav-link href{{ url_for(stats) }}統(tǒng)計(jì)看板/a /div /div /nav div classcontainer mt-4 {% with messages get_flashed_messages() %} {% if messages %} {% for message in messages %} div classalert alert-success alert-dismissible fade show rolealert {{ message }} button typebutton classbtn-close>link relstylesheet href{{ url_for(static, filenamecss/print.css) }} mediaprintprint.css的內(nèi)容media print { .no-print { display: none !important; } .container { width: 100%; max-width: none; } body { background: #fff; } .cert-box { border: 2px solid #333; padding: 48px; margin: 0 auto; max-width: 780px; font-family: SimSun, 宋體, serif; } .cert-box h2 { text-align: center; margin-bottom: 24px; } .cert-meta { line-height: 2.2; } }頁(yè)面顯示時(shí)證書(shū)詳情照常展示所有內(nèi)容用戶點(diǎn)打印預(yù)覽按鈕后瀏覽器會(huì)套用media print的規(guī)則把導(dǎo)航欄、操作按鈕全部隱藏只保留證書(shū)信息和樣式化的外框。這就是最輕量的生成PDF方案——用戶自己選擇另存為PDF就得到了電子版。證書(shū)詳情模板里打印按鈕我加在.no-print容器里div classno-print mb-3 button onclickwindow.print() classbtn btn-primary打印預(yù)覽/button a href{{ url_for(cert_list) }} classbtn btn-secondary返回列表/a /div div classcert-box h2榮譽(yù)證書(shū)/h2 div classcert-meta p證書(shū)名稱{{ cert.cert_name }}/p p證書(shū)級(jí)別{{ cert.cert_level }}/p p學(xué)生姓名{{ cert.student.name }}/p p學(xué)號(hào){{ cert.student.student_no }}/p p班級(jí){{ cert.student.class_name }}/p p發(fā)證日期{{ cert.issue_date.strftime(%Y年%m月%d日) if cert.issue_date else — }}/p p發(fā)證單位{{ cert.issuing_unit or — }}/p p證書(shū)編號(hào){{ cert.cert_no or — }}/p /div /divExcel導(dǎo)出的實(shí)現(xiàn)我用了openpyxl實(shí)際代碼app.route(/certs/export) def export_certs(): # 復(fù)用與cert_list相同的查詢邏輯獲取certs keyword request.args.get(keyword, ).strip() level request.args.get(level, ) query Certificate.query.join(Student) if keyword: like f%{keyword}% query query.filter(db.or_( Student.name.like(like), Student.student_no.like(like), Certificate.cert_name.like(like) )) if level: query query.filter(Certificate.cert_level level) certs query.order_by(Certificate.issue_date.desc()).all() wb Workbook() ws wb.active ws.title 證書(shū)匯總 headers [學(xué)號(hào), 姓名, 班級(jí), 證書(shū)名稱, 級(jí)別, 發(fā)證日期, 證書(shū)編號(hào), 發(fā)證單位] ws.append(headers) for cell in ws[1]: cell.font Font(boldTrue) for c in certs: ws.append([ c.student.student_no, c.student.name, c.student.class_name, c.cert_name, c.cert_level, c.issue_date.strftime(%Y-%m-%d) if c.issue_date else , c.cert_no or , c.issuing_unit or ]) for i, header in enumerate(headers, 1): ws.column_dimensions[get_column_letter(i)].width max(12, len(header) * 2 4) buf io.BytesIO() wb.save(buf) buf.seek(0) return send_file( buf, as_attachmentTrue, download_name證書(shū)匯總.xlsx, mimetypeapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheet )這段代碼看著不難但里面藏著一個(gè)我排查了很久的坑第一次導(dǎo)出時(shí)Excel文件下載下來(lái)是損壞的。原因出在buf.seek(0)這行——openpyxl保存后文件指針停在末尾send_file從當(dāng)前位置開(kāi)始讀讀出來(lái)的自然是空內(nèi)容。所以凡是把數(shù)據(jù)寫(xiě)入內(nèi)存緩沖區(qū)之后再發(fā)送的用戶都要記得先seek(0)。這個(gè)坑不寫(xiě)出來(lái)不知道還會(huì)坑多少人。導(dǎo)出文件名用中文也完全沒(méi)問(wèn)題Flask 2.x以后會(huì)自動(dòng)處理download_name的編碼不需要手動(dòng)做URL編碼或特殊轉(zhuǎn)義。在統(tǒng)計(jì)看板頁(yè)面我按證書(shū)級(jí)別做了匯總統(tǒng)計(jì)直接展示條形圖。圖形我用的是Bootstrap的進(jìn)度條組件沒(méi)引入圖表庫(kù)——幾條色塊就能直觀看出哪個(gè)級(jí)別的證書(shū)占比高。需要更精細(xì)的圖表時(shí)再接Chart.js但現(xiàn)階段真沒(méi)必要。6. 本機(jī)部署與局域網(wǎng)訪問(wèn)從開(kāi)發(fā)機(jī)到輔導(dǎo)員電腦系統(tǒng)開(kāi)發(fā)完成后我在自己電腦上跑得很歡輪到我交付給真正的用戶時(shí)遇到的問(wèn)題數(shù)量遠(yuǎn)超預(yù)期。下面每一條都是真金白銀換來(lái)的經(jīng)驗(yàn)。第一關(guān)就是Windows環(huán)境的Python安裝問(wèn)題。輔導(dǎo)員辦公室的電腦完全沒(méi)有Python環(huán)境。裝Python本身不難但安裝器里那個(gè)Add Python to PATH復(fù)選框默認(rèn)是不勾的一旦漏勾命令行里敲python就報(bào)不是內(nèi)部或外部命令寫(xiě)好的腳本完全跑不起來(lái)。這是我遠(yuǎn)程協(xié)助時(shí)遇到的最多的報(bào)錯(cuò)場(chǎng)景幾乎可以確診為Python環(huán)境配置第一坑。我的解決辦法是給非技術(shù)用戶做一鍵啟動(dòng)腳本。start.bat內(nèi)容如下echo off cd /d %~dp0 python -c import flask 2nul if errorlevel 1 ( echo 正在安裝依賴庫(kù)請(qǐng)稍候... pip install -r requirements.txt ) python app.pycd /d %~dp0是切換到腳本所在目錄避免用戶從別的路徑雙擊運(yùn)行導(dǎo)致文件找不到。腳本先檢查flask有沒(méi)有裝沒(méi)裝就自動(dòng)裝依賴裝完再啟動(dòng)應(yīng)用用戶全程只需要雙擊一下。這里我把判斷是否已安裝用python -c import flask的退出碼來(lái)判斷比挨個(gè)檢查包名清爽得多。應(yīng)用啟動(dòng)時(shí)監(jiān)聽(tīng)地址要改一下if __name__ __main__: app.run(host0.0.0.0, port5000, debugFalse)host0.0.0.0意味著監(jiān)聽(tīng)所有網(wǎng)絡(luò)接口局域網(wǎng)內(nèi)其他電腦可以通過(guò)這臺(tái)主機(jī)的IP訪問(wèn)。假設(shè)辦公室電腦的IP是192.168.1.8那別的老師瀏覽器里輸入http://192.168.1.8:5000就能打開(kāi)系統(tǒng)。注意debugTrue在這種交付場(chǎng)景必須關(guān)掉——調(diào)試模式開(kāi)著等于把遠(yuǎn)程執(zhí)行入口暴露在局域網(wǎng)里還有修改代碼后自動(dòng)重啟的行為會(huì)干擾正常使用。第二個(gè)常見(jiàn)坑是SQLite數(shù)據(jù)庫(kù)并發(fā)寫(xiě)。多個(gè)老師同時(shí)錄入數(shù)據(jù)時(shí)SQLite會(huì)報(bào)database is locked。這個(gè)系統(tǒng)的并發(fā)量很小我用一個(gè)連接超時(shí)配置來(lái)緩解就是前面SQLALCHEMY_ENGINE_OPTIONS里那個(gè)timeout: 10。它表示如果數(shù)據(jù)庫(kù)被占用最多等待10秒再嘗試而不是立刻失敗。對(duì)辦公室場(chǎng)景實(shí)測(cè)這個(gè)配置非常穩(wěn)完全夠用。第三個(gè)問(wèn)題是備份。所有數(shù)據(jù)都在certs.db這一個(gè)文件里我寫(xiě)了個(gè)說(shuō)明讓老師每周把數(shù)據(jù)庫(kù)文件拷貝到共享盤(pán)或U盤(pán)就算備份。這方案聽(tīng)起來(lái)原始但比Excel散落在各個(gè)聊天記錄里強(qiáng)太多。有些學(xué)院的老師用Excel管理學(xué)期初誤操作覆蓋掉上個(gè)學(xué)期的文件幾個(gè)星期的錄入全沒(méi)了的例子我是親眼見(jiàn)過(guò)的。數(shù)據(jù)庫(kù)文件單文件備份反而是最簡(jiǎn)單可靠的方案。如果你的需求是要在更大范圍內(nèi)使用比如整個(gè)學(xué)院同時(shí)幾十人操作那可以考慮用gunicorn Nginx部署在專用服務(wù)器上數(shù)據(jù)庫(kù)換MySQL。好消息是SQLAlchemy的ORM層把這些都抽象好了業(yè)務(wù)代碼幾乎不用改只需要把SQLALCHEMY_DATABASE_URI換成MySQL的連接串再處理一下并發(fā)事務(wù)就行。這也是當(dāng)初堅(jiān)持用ORM而不是裸SQL的最大回報(bào)。部署完后建議做一次完整驗(yàn)證清空數(shù)據(jù)庫(kù)文件重啟應(yīng)用、插入幾條測(cè)試數(shù)據(jù)、導(dǎo)出Excel、打印預(yù)覽、斷網(wǎng)重連。全部跑通后再正式錄入真實(shí)數(shù)據(jù)。這個(gè)驗(yàn)證步驟能提前發(fā)現(xiàn)大部分環(huán)境問(wèn)題別等數(shù)據(jù)錄了一半再折騰。7. 我對(duì)這類小型管理系統(tǒng)的幾條實(shí)在建議寫(xiě)完這套系統(tǒng)我復(fù)盤(pán)出了幾條經(jīng)驗(yàn)。它們不一定適合所有項(xiàng)目但對(duì)Flask小項(xiàng)目來(lái)說(shuō)應(yīng)該挺有參考價(jià)值。第一功能一定要做減法。統(tǒng)計(jì)大屏、微信消息推送、批量圖片導(dǎo)入、自動(dòng)生成評(píng)語(yǔ)——這些功能都能做但第一版千萬(wàn)不要碰。內(nèi)部管理系統(tǒng)的需求有一個(gè)規(guī)律用戶想象中的很多功能真正上線后根本沒(méi)人用。正確節(jié)奏是先做錄、查、改、刪、導(dǎo)出這五件事跑起來(lái)讓用戶實(shí)際試用根據(jù)真實(shí)反饋再加功能。我見(jiàn)過(guò)太多項(xiàng)目死在增強(qiáng)管理功能的路上。第二模型層一定要用ORM。即使只是SQLite也別裸寫(xiě)SQL。ORM的價(jià)值不僅在于省幾行代碼更在于你想換數(shù)據(jù)庫(kù)、想加字段、想改關(guān)聯(lián)關(guān)系時(shí)改造成本極低。我之前用裸SQL寫(xiě)過(guò)一個(gè)類似的工具加了幾個(gè)條件的查詢后SQL拼得像天書(shū)重構(gòu)時(shí)才體會(huì)到ORM的甜頭。第三模板繼承是必須的。base.html把導(dǎo)航欄、公共CSS、flash提示、腳本引用都包好每個(gè)頁(yè)面只寫(xiě)自己獨(dú)有的{% block content %}全站一致性和后期維護(hù)都會(huì)輕松很多。我看到不少新手把同樣的導(dǎo)航欄復(fù)制到七八個(gè)頁(yè)面里后面改個(gè)鏈接要改七八處這種苦真沒(méi)必要吃。第四字符編碼問(wèn)題要前置處理。從Python源碼到數(shù)據(jù)庫(kù)再到HTML模板全程統(tǒng)一UTF-8基本不會(huì)遇到亂碼。開(kāi)發(fā)工具、編輯器的默認(rèn)編碼都設(shè)成UTF-8數(shù)據(jù)庫(kù)里已有的亂碼數(shù)據(jù)基本都是源頭導(dǎo)入時(shí)編碼不對(duì)造成的導(dǎo)入前先確認(rèn)原始文件的編碼。這個(gè)習(xí)慣能讓你少掉一大半頭發(fā)。最后說(shuō)一下后續(xù)擴(kuò)展方向。這套系統(tǒng)目前沒(méi)有登錄功能如果你部署的環(huán)境網(wǎng)絡(luò)不安全可以考慮加一層簡(jiǎn)單的登錄驗(yàn)證——Flask-Login是現(xiàn)成的方案往現(xiàn)在的代碼里接入也不算復(fù)雜。證書(shū)圖片上傳、批量錄入、學(xué)院內(nèi)多部門(mén)數(shù)據(jù)隔離也都可以做。但我的建議還是那句話先把當(dāng)前這套用順用戶真的提了明確需求再去動(dòng)代碼否則你會(huì)一邊寫(xiě)一邊替用戶設(shè)計(jì)他根本不需要的功能。對(duì)我個(gè)人來(lái)說(shuō)這類內(nèi)部工具的技術(shù)含量不算高但它解決了一個(gè)具體場(chǎng)景里反復(fù)出現(xiàn)的真實(shí)痛點(diǎn)——從用Excel翻找一下午到輸入一個(gè)名字點(diǎn)回車所有證書(shū)記錄一秒出來(lái)這種變化是實(shí)實(shí)在在的。你的學(xué)院或部門(mén)如果有類似的需求照著這套思路搭一個(gè)出來(lái)花的時(shí)間一定比你想象中少得多。