一、Python 版本如何选？稳定版与测试版区分

选型建议

个人学习 / 新项目开发：优先3.10~3.12，兼顾新特性与长期官方维护，LLM 框架 LangChain、向量库兼容性最优；

老旧线上项目：沿用项目原有 Python 版本，不盲目升级，避免第三方包兼容报错；

不推荐预发布 ：存在大量库适配问题，生产环境禁用。

二、虚拟环境：解决 Python 依赖冲突必备

1. 作用

2. 优缺点

常用命令

# 创建虚拟环境python -m venv venv# Windows激活venv\Scripts\activate# Mac/Linux激活source venv/bin/activate# 退出虚拟环境deactivate

三、PIP 腾讯云国内镜像加速，告别下载超时

# 单次安装临时使用镜像pip install xxx -i https://mirrors.cloud.tencent.com/pypi/simple# 全局配置镜像（一劳永逸）pip config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple

四、LLMOps 大型语言模型运维

2. 框架选型理由

Python 生态完善，海量 AI、机器学习、LLM 开源库，是 LangChain 首选开发语言；

Flask 属于微框架，内核精简、上手简单，相比 Django 轻量化，灵活适配 LLMOps 定制化开发。

五、企业规范项目目录 + 代码命名规范

├── app

项目程序入口

├── config

全局配置文件

├── internal

项目核心代码

│   ├── core

LLM、向量、Prompt核心逻辑

│   ├── handler

Controller控制器

│   ├── service

业务服务层

│   ├── middleware

中间件(登录校验等)

│   ├── model

数据库ORM模型

│   ├── router

接口路由

│   ├── schema

请求入参、出参结构体

├── pkg

自研扩展工具包

├── storage

本地文件存储

├── test

单元测试

├── venv

项目虚拟环境

├── requirements.txt

项目依赖清单

统一命名规则

文件 / 模块

：全小写 + 下划线user_service.py；

类名

：大驼峰UserService；

函数 / 变量

：小写下划线get_user_info；

常量

：全大写MAX_UPLOAD_SIZE；

私有属性

：单下划线开头_private_data（编码约定，Python 无强制私有）。

项目请求流转流程

六、依赖注入：用 Injector 优化代码解耦

什么是依赖注入

快速上手 Injector

pipinstallinjector

frominjectorimportinject,Injector

classUserService:

pass

@inject

classUserController:

def__init__(self,service:UserService):

self.service=service

自动注入实例，无需手动new对象

injector=Injector()

ctrl=injector.get(UserController)

七、PostgreSQL 多环境快速部署（Windows/Ubuntu/Docker）

1.Windows 安装

2.Ubuntu 安装

sudoaptupdate

sudoaptinstallpostgresql postgresql-contrib

启停服务

sudosystemctl start postgresql

sudosystemctl stop postgresql

进入数据库修改密码

sudo-upostgres psql

\password postgres

3.Docker 一键部署（推荐开发环境）

拉取镜像

dockerpull postgres

启动容器

dockerrun--namepostgres-dev-ePOSTGRES_PASSWORD=postgres-p5432:5432-dpostgres

八、接口调试：Postman

结语