从零搭建个人技术开发档案管理软件 附完整可落地实操步骤

准备工具与环境安装

本文搭建的是轻量个人技术开发档案软件，支持存储项目信息、开发文档、踩坑记录、依赖地址，所有工具免费开源，本地即可运行，不需要服务器，零成本落地。

安装依赖

确认你已经安装Python3.8及以上版本，未安装的用户直接访问地址下载安装：https://www.python.org/downloads/，安装时必须勾选Add Python to PATH选项，否则会无法运行后续命令。

安装完成后打开命令行，直接执行以下命令安装所有依赖：

``` pip install flask flask-sqlalchemy ```

初始化项目结构

在本地电脑任意位置新建文件夹，命名为dev-archive，在文件夹内新建一个名为app.py的主程序文件，最终结构如下：

• dev-archive/
• ├─ app.py （主程序文件，手动新建）
• └─ dev_archive.db （数据库文件，程序自动生成，无需手动创建）

打开你新建的app.py，直接复制粘贴以下完整可运行代码，所有配置已经预设完成，不需要任何修改：

``` from flask import Flask, render_template_string, request, redirect from flask_sqlalchemy import SQLAlchemy import os app = Flask(__name__) base_dir = os.path.abspath(os.path.dirname(__file__)) app.config['SQLALCHEMY_DATABASE_URI'] = f'sqlite:///{os.path.join(base_dir, "dev_archive.db")}' app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False db = SQLAlchemy(app) 开发档案数据模型 class DevArchive(db.Model): id = db.Column(db.Integer, primary_key=True) title = db.Column(db.String(100), nullable=False) category = db.Column(db.String(50), nullable=False) code_url = db.Column(db.String(200)) doc_url = db.Column(db.String(200)) note = db.Column(db.Text, nullable=False) create_time = db.Column(db.DateTime, default=db.func.now()) 自动创建数据库表 with app.app_context(): db.create_all() 前端页面模板 HTML_TPL = ''' ''' @app.route('/') def index(): all_items = DevArchive.query.order_by(DevArchive.create_time.desc()).all() return render_template_string(HTML_TPL, items=all_items) @app.route('/add', methods=['POST']) def add(): new_item = DevArchive( title = request.form.get('title'), category = request.form.get('category'), code_url = request.form.get('code_url'), doc_url = request.form.get('doc_url'), note = request.form.get('note') ) db.session.add(new_item) db.session.commit() return redirect('/') @app.route('/delete/') def delete(item_id): item = DevArchive.query.get(item_id) db.session.delete(item) db.session.commit() return redirect('/') if __name__ == '__main__': app.run(debug=True, port=5000) ```

启动使用操作

启动步骤

• Windows系统按Win+R输入cmd回车打开命令提示符，Mac系统打开终端
• 输入命令进入你创建的dev-archive文件夹，示例（Windows D盘路径）：cd D:\project\dev-archive，Mac示例：cd /Users/你的用户名/project/dev-archive
• 执行启动命令：python app.py

启动成功后，命令行会输出 Running on http://127.0.0.1:5000，打开浏览器输入该地址，即可进入技术开发档案软件。

核心操作说明

新增档案

在首页表单选择分类，填写技术或项目名称，可填写源码地址、文档地址，最后在备注框填写核心要点、踩坑记录，点击保存即可完成新增，新增档案自动排在列表最顶部。

删除档案

找到需要删除的档案，点击档案底部的删除按钮，确认后即可永久删除，操作不可逆，删除前请确认。

备份与迁移

所有档案数据都存储在项目文件夹内的dev_archive.db文件中，需要备份时直接复制该文件到其他位置即可；换电脑使用时，把该文件放到新项目的对应文件夹，即可恢复所有数据。

可选扩展功能

如果需要添加搜索功能，可在页面添加搜索框，修改查询语句为：DevArchive.query.filter(DevArchive.title.contains(search_key)).order_by(DevArchive.create_time.desc()).all()，即可实现按标题搜索。

如果需要外网访问，可将项目部署到云服务器，把启动代码修改为：app.run(debug=False, host='0.0.0.0', port=5000)，开放服务器5000端口后，即可通过公网IP访问。