1. 课程概述与环境准备:Node.js、Python、Git 等工具的安装与配置

大家好,欢迎来到《前端后端环境联调实战》的第一章。

在做联调之前,我们得先把“兵器”准备好。我记得刚开始做全栈项目时,光搭环境就折腾了两天,各种版本冲突、环境变量找不到。说白了,环境配不好,后面全是坑。

这一章咱们就把 Node.js、Python、Git 这几个核心工具装好、配好。我会把我在项目中踩过的坑也一并告诉你。

1.1 课程概览:我们要解决什么问题?

这门课的核心目标只有一个:让你能独立完成前端和后端的接口联调。

你想想看,前端调后端接口,动不动就跨域、403、数据格式对不上。很多时候不是代码写错了,而是环境没配明白。

整个课程会覆盖 30 个章节,从工具安装到真实项目联调,一步步来。今天咱们先把地基打好。

我的建议: 别急着往后翻。把这一章的环境老老实实搭一遍,后面会省很多事。

1.2 Node.js 安装与配置

Node.js 是前端工程化的基石。npm、Webpack、Vite 都离不开它。说白了,没有 Node.js,现代前端开发基本没法玩。

1.2.1 下载与安装

我建议你直接去官网下载 LTS(长期支持)版本。别追新版本,容易踩坑。

  • Windows: 下载 .msi 安装包,一路 Next 即可。记得勾选“Add to PATH”。
  • macOS: 推荐用 Homebrew 安装:brew install node
  • Linux(Ubuntu): 用 nvm 管理版本最省心。
我曾经踩过的坑: 直接用系统 apt 装 Node.js,结果版本特别老,npm 装什么包都报错。后来换成 nvm,世界清净了。

1.2.2 验证安装

打开终端,敲下面两条命令:

node -v
npm -v

能看到版本号,就说明装好了。例如:

v18.17.0
9.6.7

1.2.3 配置 npm 镜像源

国内直接用 npm 官方源,下载速度你懂的……我习惯用淘宝镜像。

npm config set registry https://registry.npmmirror.com

验证一下:

npm config get registry
重点: 这一步一定要做。不然你装一个包等五分钟,心态会崩。

1.3 Python 安装与配置

后端联调中,Python 经常用来写 Mock 服务或者简单的接口。我个人习惯用 Python 3.10+。

1.3.1 下载与安装

  • Windows: 下载官网安装包,安装时别忘了勾选“Add Python to PATH”。
  • macOS: brew install python@3.10
  • Linux: 一般自带 Python3,用 sudo apt install python3 更新一下。

1.3.2 验证安装

python --version
pip --version

1.3.3 虚拟环境

做项目时,每个项目的依赖最好隔离。我遇到过最惨的一次,全局装了一堆包,最后版本冲突,项目跑不起来。

创建虚拟环境:

python -m venv myenv

激活它:

  • Windows: myenv\Scripts\activate
  • macOS/Linux: source myenv/bin/activate
避坑指南: 激活后,终端前面会出现 (myenv) 字样。如果没有,说明没激活成功。

1.4 Git 安装与配置

Git 是版本控制的标配。联调过程中,前后端代码要同步,没有 Git 根本没法协作。

1.4.1 下载与安装

  • Windows: 下载 Git for Windows,一路 Next。
  • macOS: brew install git
  • Linux: sudo apt install git

1.4.2 配置用户名和邮箱

这是必须的,不然没法提交代码。

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

1.4.3 配置 SSH 密钥

方便连接 GitHub/Gitee。我之前用 HTTPS 方式,每次都要输密码,烦得很。

ssh-keygen -t rsa -b 4096 -C "your.email@example.com"

生成后,把公钥(~/.ssh/id_rsa.pub)添加到你的代码托管平台。

1.5 其他辅助工具

工具 用途 备注
VS Code 代码编辑器 安装 ESLint、Prettier 插件
Postman 接口测试 调试接口必备
nvm Node.js 版本管理 切换版本神器
总结一下: Node.js 管前端,Python 管后端 Mock,Git 管版本。这三样是联调的“三驾马车”。

1.6 本章知识体系

下面这张图,把这一章的核心脉络串起来了。你一看就明白。

第1章:课程概述与环境准备 — 知识体系 课程概述 Node.js + npm Python + pip Git npm 镜像源配置 虚拟环境 SSH 💡 核心思路:先本地配好工具,再选 IDE 和 Mock 工具,最后跑通 Hello World 每个工具装好后都做一次验证,确保可用再继续下一步

好了,这一章就到这里。工具都装好了,咱们后面就可以直接动手写代码。