企业官网建设流程全解析

如何將別人寫好的代码在自己电脑本地运行？是困扰新手的共性问题。基本思路是先安装依赖包，然后配置环境，最后运行调试。

一.安装依赖包

1.后端依赖包安装
用Vscode加载项目文件，找到项目依赖包说明文件，例如requirements.txt。
创建虚拟环境：

python-m venv Projectname

虚拟环境可以隔离不同项目的依赖包，避免版本冲突。 Projectname是虚拟环境的名称，建议使用项目相关的名称，如myproject_env或 venv

激活虚拟环境：

Projectname\Scripts\activate

进入后端环境安装包所在的根目录，例如backup-python：

cd D:\Projectname\backup-python

打开终端执行安装命令：

pip install-r requirements.txt-i"https://pypi.tuna.tsinghua.edu.cn/simple"

如果执行速度慢或存在版本冲突等问题，可以先安装核心包，再安装其余包

# 1. 先安装镜像存在的底层核心包pip install pydantic-core==2.35.0--only-binary pydantic-core-i"https://mirrors.aliyun.com/pypi/simple/"# 2. 安装其余所有包，自动匹配兼容pydantic版本pip install fastapi==0.115.6uvicorn[standard]==0.34.0python-multipart==0.0.20pydantic-settings==2.7.0openpyxl==3.1.5python-pptx==1.0.2python-docx==1.1.2xlrd==2.0.2openai==1.58.1aiofiles==24.1.0jinja2==3.1.5python-dateutil==2.9.0--upgrade-i"https://mirrors.aliyun.com/pypi/simple/"

安装完成后分别执行以下命令检查

pip check

pip install-r requirements.txt--dry-run-i"https://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:8000

2.启动后端
在前端文件存放的根目录下，输入命令：npm run dev
终端会输出前端访问地址
本地浏览器登陆访问地址即可运行项目。