Hot-Knowledge-Sharing-Website 开发环境配置指南

本指南主要用于本地测试环境的搭建与配置，涵盖数据库、前端和后端的部署说明。

1. 数据库部署 (PostgreSQL)

Windows 环境

• 官方网站: PostgreSQL (请参考官方文档进行安装)

• 环境变量配置:

  • 将安装目录下的 bin 文件夹（例如 D:\PostgreSQL\bin）添加到系统环境变量 PATH 中。

macOS 环境

1. 安装 PostgreSQL: 直接在终端运行以下命令（需确保已安装 Homebrew）：

   brew install postgresql@18

等待安装完成。

1. 启动服务: 使用以下命令启动 PostgreSQL 后台进程：

   brew services start postgresql

注意: 可在 "系统设置 -> 通用 -> 登录项与扩展" 中管理后台进程。

1. 配置环境变量: 将 PostgreSQL 添加到 PATH 中：

   export PATH="/usr/local/opt/postgresql@18/bin:$PATH"

命令行连接 (通用)

• 连接数据库:

  psql -U username -p 5432

(注：如果安装时修改了端口，请替换 -p 后面的端口号，例如 -p 23306)

2. 前端部署 (Vue.js)

前置要求

• Node.js: 请先安装 Node.js 环境。

  • 下载地址: nodejs.org
  • 验证安装:

  node -v
  npm -v
  

搭建与运行

1. 初始化项目 (如果尚未创建):

   npm create vite@latest website-frontend -- --template vue

1. 启动开发服务器:

   # 进入前端目录
   cd website-frontend

   # 安装依赖
   npm install

   # 启动项目
   npm run dev

说明: npm install 会读取 package.json 并将所有依赖安装到 node_modules 目录中。

3. 后端部署 (Flask)

前置要求

• Python: 确保已安装 Python 环境。

搭建与运行

1. 创建虚拟环境:

   python -m venv .venv

1. 激活虚拟环境:

• Windows:
  

   .venv\Scripts\activate
  

• macOS/Linux:
  

   source .venv/bin/activate
  

1. 安装 Flask:

   pip install flask