第2章开发环境搭建

2、开发环境搭建：Python环境安装、Django框架安装、Vue CLI创建项目、数据库选型（MySQL/PostgreSQL）、IDE配置

好，咱们正式开始动手了。

这一章，说白了就是「把家伙事儿备齐」。我见过太多新手，代码写了两天发现环境没配好，回头重来，心态直接崩了。所以咱们一步到位，把 Python、Django、Vue、数据库、IDE 全捋一遍。

2.1 Python 环境安装

我个人习惯用 Python 3.10+。为什么？因为 Django 4.2 LTS 对 3.10 支持最好，而且 3.11、3.12 有些第三方库还没完全跟上。你想想看，项目做一半发现某个库不兼容，那得多闹心。

推荐版本：Python 3.10.x

下载地址：python.org → Downloads → 选 3.10.x

安装时有个坑，我踩过——一定要勾选「Add Python to PATH」。不勾的话，你后面在命令行敲 python 会提示找不到命令。嗯，别问我怎么知道的。

装完验证一下：

python --version
# 输出：Python 3.10.x

pip --version
# 输出：pip 22.x from ...

如果 pip 版本太低，顺手升个级：

python -m pip install --upgrade pip

小技巧：我建议用虚拟环境。每个项目独立一套 Python 包，互不干扰。后面咱们用 venv 或 virtualenv 都行，但 Django 项目我习惯用 poetry，更优雅。

2.2 Django 框架安装

Python 装好了，接下来装 Django。咱们这个 ERP 系统用 Django 4.2 LTS，长期支持版，稳得很。

pip install django==4.2

验证一下：

python -m django --version
# 输出：4.2.x

我曾经遇到过一个问题：装完 Django 后，运行 django-admin 提示找不到命令。后来发现是 Python Scripts 目录没在 PATH 里。解决办法很简单——重新安装 Python，勾选 PATH 选项，或者手动把 C:\Users\你的用户名\AppData\Local\Programs\Python\Python310\Scripts 加到环境变量里。

注意：别用 pip install django 直接装最新版。最新版可能不稳定，而且有些第三方插件还没适配。咱们做项目，求稳不求新。

2.3 Vue CLI 创建项目

前端咱们用 Vue 3 + Vue CLI。为什么不用 Vite？Vite 确实快，但 Vue CLI 生态更成熟，插件更全。咱们做 ERP，稳定第一。

先装 Node.js（推荐 18 LTS）：

node -v
# 输出：v18.x.x

npm -v
# 输出：9.x.x

然后装 Vue CLI：

npm install -g @vue/cli

vue --version
# 输出：@vue/cli 5.x.x

创建项目：

vue create erp-frontend

这里会弹出选项，我建议选：

Vue 3（别选 2，都什么年代了）
Babel（兼容旧浏览器）
Router（后面做页面跳转用）
Vuex 或 Pinia（状态管理，我推荐 Pinia，更轻量）
ESLint + Prettier（代码规范，团队协作必备）

避坑指南：我曾经在创建项目时选了「Manually select features」，结果忘了选 Router，后面又手动加，麻烦得很。所以一开始就选全，省事。

创建完成后：

cd erp-frontend
npm run serve

浏览器打开 http://localhost:8080，看到 Vue 的欢迎页面，就成了。

2.4 数据库选型：MySQL 还是 PostgreSQL？

这是个老生常谈的问题。我直接说结论：

对比项	MySQL	PostgreSQL
安装难度	简单（Windows 有安装包）	中等（需要配一些参数）
事务支持	✅ 支持	✅ 支持（更完善）
JSON 字段	✅ 支持（5.7+）	✅ 支持（原生 JSONB）
全文索引	✅ 支持	✅ 支持（更强大）
并发性能	中等	优秀（MVCC 机制）
社区生态	非常成熟	成熟

我个人建议：选 PostgreSQL。为什么？

ERP 系统涉及大量复杂查询、报表统计，PG 的窗口函数、CTE 用起来太爽了
JSONB 字段可以灵活存储一些非结构化数据，比如商品扩展属性
事务隔离级别更严格，不容易出现脏读、幻读

当然，如果你团队对 MySQL 更熟，用 MySQL 8.0 也没问题。我早期一个项目用的 MySQL，后来迁移到 PG，说实话有点后悔——早知道一开始就用 PG 了。

本课程选用：PostgreSQL 15+

下载地址：postgresql.org → Download → 选对应系统版本

安装时记住：

设置一个你能记住的密码（比如 postgres）
端口默认 5432
安装完成后，用 pgAdmin 或命令行连一下试试

psql -U postgres
# 输入密码后进入 psql 交互界面
# 输入 \l 查看数据库列表

2.5 IDE 配置

工欲善其事，必先利其器。我推荐 VS Code，免费、轻量、插件多。

必装插件：

Python（微软官方，语法高亮、智能提示）
Django（模板语法高亮）
Vue Language Features (Volar)（Vue 3 支持）
ESLint（代码规范检查）
Prettier（代码格式化）
PostgreSQL（数据库连接，可选）

我个人习惯把 VS Code 的终端设置为 Git Bash（Windows）或默认终端（Mac/Linux）。这样敲命令方便。

另外，我建议配置一下 settings.json：

{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "python.defaultInterpreterPath": "你的虚拟环境路径",
  "files.autoSave": "onFocusChange"
}

小技巧：如果你用 PyCharm，也可以。但 VS Code 更轻量，而且前后端都能写。我平时开一个 VS Code 窗口，左边写 Django，右边写 Vue，分屏操作，效率很高。

2.6 验证环境是否打通

最后，咱们快速验证一下整个链路：

Python 能跑 Django
Vue 能启动开发服务器
PostgreSQL 能连上

创建一个测试 Django 项目：

django-admin startproject erp_backend
cd erp_backend
python manage.py runserver

浏览器打开 http://127.0.0.1:8000，看到 Django 的小火箭，说明后端通了。

再打开 http://localhost:8080，看到 Vue 欢迎页，说明前端也通了。

数据库连接测试，咱们后面章节再细说，但至少现在 PG 能连上，心里就有底了。

总结一下：

Python 3.10 + Django 4.2 LTS
Node 18 + Vue CLI 5 + Vue 3
PostgreSQL 15+
VS Code + 必备插件

环境搭好了，后面就是写代码的事了。别急，咱们一章一章来。

好，这一章就到这儿。下一章咱们开始创建 Django 项目，配置数据库连接，写第一个 Model。

📚 课程目录

2、开发环境搭建：Python环境安装、Django框架安装、Vue CLI创建项目、数据库选型（MySQL/PostgreSQL）、IDE配置

2.1 Python 环境安装

2.2 Django 框架安装

2.3 Vue CLI 创建项目

2.4 数据库选型：MySQL 还是 PostgreSQL？

2.5 IDE 配置

2.6 验证环境是否打通