如何將別人寫好的代码在自己电脑本地运行是困扰新手的共性问题。基本思路是先安装依赖包然后配置环境最后运行调试。一.安装依赖包1.后端依赖包安装用Vscode加载项目文件找到项目依赖包说明文件例如requirements.txt。创建虚拟环境python-m venv Projectname虚拟环境可以隔离不同项目的依赖包避免版本冲突。 Projectname是虚拟环境的名称建议使用项目相关的名称如myproject_env或 venv激活虚拟环境Projectname\Scripts\activate进入后端环境安装包所在的根目录例如backup-pythoncd D:\Projectname\backup-python打开终端执行安装命令pip install-r requirements.txt-ihttps://pypi.tuna.tsinghua.edu.cn/simple如果执行速度慢或存在版本冲突等问题可以先安装核心包再安装其余包# 1. 先安装镜像存在的底层核心包pip install pydantic-core2.35.0--only-binary pydantic-core-ihttps://mirrors.aliyun.com/pypi/simple/# 2. 安装其余所有包自动匹配兼容pydantic版本pip install fastapi0.115.6uvicorn[standard]0.34.0python-multipart0.0.20pydantic-settings2.7.0openpyxl3.1.5python-pptx1.0.2python-docx1.1.2xlrd2.0.2openai1.58.1aiofiles24.1.0jinja23.1.5python-dateutil2.9.0--upgrade-ihttps://mirrors.aliyun.com/pypi/simple/安装完成后分别执行以下命令检查pip checkpip install-r requirements.txt--dry-run-ihttps://mirrors.aliyun.com/pypi/simple/2.前端依赖包安装安装 Node.js版本 16进入前端文件存放的根目录例如cd frontend在终端输入命令安装前端依赖npm install二.配置环境1.后端环境配置进入后端文件存放的根目录能看到.env.example的文件夹例如cd backup-python复制模板生成配置文件直接手动复制 .env.example 重命名为 .env用记事本 / VSCode 打开 .env 文件修改核心参数数据库若无本地 MySQL可使用 docker 内置数据库配置大模型配置填入你的大模型 API Key / 接口地址人才评估核心依赖跨域、端口保持默认即可2.前端环境配置修改前端接口地址打开 vite.config.js 或前端环境文件将后端代理地址改为 http://127.0.0.1:8000三.运行调试1.启动后端在后端文件存放的根目录直接启动终端输入命令uvicorn app.main:app--host0.0.0.0--port8000--reload启动成功后后端接口地址 http://127.0.0.1:80002.启动后端在前端文件存放的根目录下输入命令npm run dev终端会输出前端访问地址本地浏览器登陆访问地址即可运行项目。