把三端环境一次配好，把常用命令放在手边。这一页是全栈开发的「装备间」：环境清单、三端搭建步骤、命令速查、Postman 集合获取、常见报错排查。建议动手前先过一遍。
| 用途 | 推荐 | 版本 / 说明 |
|---|---|---|
| Python 环境 | Python + venv 虚拟环境 | 3.10 及以上（建议 3.11 / 3.12） |
| 后端依赖 | Flask、Flask-SQLAlchemy、PyMySQL、Flask-JWT-Extended、Flask-CORS、Flask-Migrate | 以最新稳定版为准；课程提供 requirements.txt |
| 数据库 | MySQL Server | 8.x（字符集 utf8mb4 / 引擎 InnoDB） |
| 数据库客户端 | Navicat 或 DBeaver（社区版免费） | DBeaver 跨平台、免费 |
| Node 运行时 | Node.js LTS | 18 / 20 LTS；包管理器 npm 或 pnpm |
| 前端构建 | Vite | 随 create-vue 脚手架生成 |
| 代码编辑器 | VS Code（Volar、Python、ESLint 插件）或 PyCharm | 前后端通吃 |
| 接口测试 | Postman 或 Apifox | Apifox 中文、可生成文档 |
| 版本管理 | Git + Gitee / GitHub | 养成提交习惯，作为过程性考核依据 |
| 浏览器调试 | Chrome DevTools | 看网络请求、调接口 |
# 登录 MySQL（-u 用户名 -p 回车后输密码）
mysql -u root -p
# 在 MySQL 里执行（或直接在客户端里打开 hiwen.sql 运行）
source pyweb/sql/hiwen.sql;
# 验证
SHOW DATABASES; -- 应能看到 hiwen
USE hiwen;
SHOW TABLES; -- 应看到 7 张表 + 1 个视图# 进入后端项目目录
cd pyweb/code/hiflask
# 创建并激活虚拟环境
python -m venv venv
# Windows:
venv\Scripts\activate
# macOS / Linux:
source venv/bin/activate
# 安装依赖
pip install -r requirements.txt
# 启动开发服务器
flask run --debug# 方式一：从零创建
npm create vue@latest hivue # 按提示勾选 Router / Pinia
cd hivue
npm install
npm run dev
# 方式二：用课程骨架
cd pyweb/code/hivue
npm install
npm run devmysql -u root -p
SHOW DATABASES;
USE hiwen;
SHOW TABLES;
DESC works;
source xx.sql;
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip freeze > requirements.txt
flask run --debug
node -v
npm install
npm run dev
npm run build
npm run preview
git init
git add .
git commit -m "msg"
git remote add origin <url>
git push -u origin main