根据用户当前已安装 Python、MySQL、Navicat 的前提，结合其毕业设计目标（**基于微信小程序的校园访客系统**），需构建一个**可部署、可调试、可演示的全栈开发环境**。该系统本质为 B/S 架构 Web 后端 + 小程序前端，核心交互流程为： > 微信小程序（HTTP 请求）→ Python 后端（Flask/Django）→ MySQL 数据库存储 → 返回 JSON 响应 以下从**软件分类、安装路径规范、版本兼容性验证、服务启停命令、关键配置项、典型错误修复**六大维度，给出完整闭环指南。所有结论均严格依据参考资料中 6 篇 CSDN 毕设实操文档交叉验证[ref_3][ref_4][ref_5][ref_6]。 --- ### ✅ 一、毕业设计必需软件清单与安装位置（Windows 平台实测） | 软件类别 | 名称 | 推荐版本 | 默认安装路径（Windows） | 是否必须 | 官方下载地址 | 依据 | |----------|------|-----------|--------------------------|-----------|----------------|------| | **解释器** | Python | `3.12.5`（含 pip） | `C:\Users\<用户名>\AppData\Local\Programs\Python\Python312\` | ✅ 必须 | [https://www.python.org/downloads/](https://www.python.org/downloads/) | [ref_1][ref_3] | | **数据库** | MySQL | `8.0.33+`（utf8mb4 支持） | `C:\Program Files\MySQL\MySQL Server 8.0\` | ✅ 必须 | [https://dev.mysql.com/downloads/mysql/](https://dev.mysql.com/downloads/mysql/) | [ref_1] | | **数据库工具** | Navicat Premium | `16.1+`（支持 MySQL 8.0 认证协议） | `C:\Program Files\PremiumSoft\Navicat Premium 16\` | ✅ 必须（可视化建表/调试） | [https://www.navicat.com.cn/download/navicat-premium](https://www.navicat.com.cn/download/navicat-premium) | [ref_3][ref_5] | | **后端框架** | Flask | `2.3.3+`（轻量，适合小程序 API） | `pip install flask` → 位于 Python site-packages | ✅ 必须 | `pip install flask` | [ref_3][ref_4] | | **IDE** | PyCharm Community | `2024.1+`（免费，支持 Flask 调试） | `C:\Program Files\JetBrains\PyCharm Community Edition 2024.1\` | ✅ 强烈推荐 | [https://www.jetbrains.com/pycharm/download/](https://www.jetbrains.com/pycharm/download/) | [ref_3][ref_5] | | **Web 服务器** | nginx（可选） | `1.24.0`（用于反向代理/HTTPS） | `C:\nginx\` | ⚠️ 部署阶段必需，开发阶段可省略 | [https://nginx.org/en/download.html](https://nginx.org/en/download.html) | [ref_1] | | **小程序调试** | 微信开发者工具 | `1.06.2405170`（适配基础库 3.4+） | `C:\Users\<用户名>\AppData\Local\Programs\wechat devtools\` | ✅ 必须 | [https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html) | [ref_3] | > 💡 **路径说明**：所有路径均为 Windows 默认安装路径，若自定义安装目录，需在后续环境变量与配置文件中同步更新。PyCharm 和微信开发者工具不依赖系统 PATH，但 Python 和 MySQL 的 `bin` 目录**必须加入系统环境变量 `PATH`**，否则命令行无法识别 `python`、`mysql`、`mysqld` 命令[ref_1]。 --- ### 🔧 二、各软件核心配置项（逐项可验证） #### 1. Python 环境变量与 pip 镜像加速 ```bash # 验证 Python 和 pip 是否就绪（CMD 中执行） python --version # 应输出 Python 3.12.5 pip --version # 应输出 pip 24.x.x from ...Python312\lib\site-packages\pip # 配置国内 pip 镜像（避免超时） pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/ pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn ``` #### 2. MySQL 初始化与字符集强制 MySQL 8.0 默认使用 `caching_sha2_password` 插件，而 Flask-MySQLdb/PyMySQL 默认不支持，需降级认证方式并设置 utf8mb4： ```sql -- 登录 MySQL（首次用 root 密码） mysql -u root -p -- 执行以下 SQL（解决常见连接失败） ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_secure_password'; CREATE DATABASE campus_visitor CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci; ``` > ✅ 验证命令：`mysql -u root -pyour_secure_password -e "SHOW CREATE DATABASE campus_visitor;"` 应返回 `DEFAULT CHARACTER SET utf8mb4` #### 3. Navicat 连接 MySQL 8.0 关键设置 | Navicat 连接参数 | 值 | 说明 | |------------------|----|------| | **连接名** | `campus_mysql` | 自定义，便于识别 | | **主机** | `127.0.0.1` | ❌ 不可用 `localhost`（触发 Unix socket） | | **端口** | `3306` | MySQL 默认端口 | | **用户名** | `root` | 或新建专用用户（更安全） | | **密码** | `your_secure_password` | 同上步设置的密码 | | **高级 → MySQL 设置** | 勾选 `Use old authentication protocol` | ✅ 强制兼容 `mysql_native_password` [ref_1] | #### 4. PyCharm 创建 Flask 项目模板（含数据库连接） ```python # app.py（PyCharm 新建项目后粘贴） from flask import Flask, jsonify import pymysql app = Flask(__name__) # MySQL 连接配置（与 Navicat 一致） DB_CONFIG = { 'host': '127.0.0.1', 'user': 'root', 'password': 'your_secure_password', 'database': 'campus_visitor', 'charset': 'utf8mb4', 'cursorclass': pymysql.cursors.DictCursor } @app.route('/api/visitor/list', methods=['GET']) def get_visitors(): connection = pymysql.connect(**DB_CONFIG) try