STEP 1
这两个词搞懂了,"配环境"就不再神秘
代码写完只是一堆文字,需要一个专门的程序把它跑起来。JavaScript 代码要有 Node.js 才能在电脑上执行,Python 代码要有 Python 才能跑。没有对应的运行环境,代码就只是个文本文件。
类比:安卓的 App 装不进 Windows,Windows 的软件也跑不了安卓——不同代码需要对应的运行环境才能执行
开发者写好的代码工具库,叫"包"或"依赖"。包管理器帮你一键下载、安装、管理这些工具。Node.js 用 npm/pnpm,Python 用 pip,不用自己去各个网站手动下载。
类比:App Store,想要什么功能,搜一下一键安装
一句话总结"编程环境"是什么
编程环境 = 代码运行环境(让代码能跑)+ 包管理器(管理依赖)。两样配齐,代码就能跑起来。
STEP 2
按需装,不需要全装;每个装好后用验证命令确认
推荐版本:LTS v22
包管理:npm / pnpm / yarn
做网站、小程序、App 都离不开它。你用 AI 生成的项目代码,绝大多数都需要先装 Node.js 才能跑起来——它就是让这些项目在你电脑上"活起来"的基础程序。装好之后自带 npm 包管理器,可以一键安装项目所需的各种工具包。
node -v — 装好后运行验证 适合场景
做网站 / 小程序 / 全栈 App
推荐版本:3.12+
包管理:pip / uv / conda
AI、数据处理、FastAPI 后端的首选语言。调用大模型 API、跑机器学习脚本都要用。不做 AI 或数据相关项目可以跳过,但做了就绕不开。
python -V — 装好后运行验证 适合场景
AI 应用 / 数据分析 / 后端 API
推荐版本:2.x
包管理:(无包管理器)
代码版本管理工具。克隆项目模板、保存每次改动、多人协作、部署到 Vercel/Railway 都要用到它。装了 Git 才能用 GitHub,才能一键 push 上线。
git -v — 装好后运行验证 适合场景
所有项目,无例外
推荐版本:JDK 21 LTS
包管理:Maven / Gradle
Android 开发和 Spring Boot 后端的基础。装完需要配置 JAVA_HOME 环境变量。不做 Android 或 Java 后端可以跳过,不影响其他项目。
java -version — 装好后运行验证 适合场景
Android 开发 / Spring Boot
推荐安装顺序
每装完一个,打开终端跑一下验证命令,看到版本号就说明装好了。
STEP 3
遇到问题,对照这里先查一遍
"node 不是内部或外部命令"
原因:Node.js 没装,或者装了但 PATH 没配对
→ 解决:重新安装 Node.js,重启终端再试
"python 不是内部或外部命令"
原因:Python 没装,或者 Windows 上装了 Python 3 但命令是 python3
→ 解决:用 python3 试试;或重装时勾选"Add Python to PATH"
"我装了 X,但 AI 编辑器里还是报错"
原因:AI 编辑器开着时才安装的,它还没读到新的 PATH
→ 解决:关掉 Cursor/Trae 等编辑器,重新打开
"在我电脑能跑,在别人那跑不起来"
原因:对方没装对应的运行时,或者版本不一样
→ 解决:给对方一份 README 写清楚"先装 Node.js 18+",用 .nvmrc 锁定版本
"npm install 报错 / 超慢"
原因:默认 npm 源在境外,国内访问慢;或者 node_modules 被缓存了
→ 解决:换镜像:npm config set registry https://registry.npmmirror.com
配环境的核心心法
搞懂概念了,下一步去动手装
去学习路径里找对应的安装教程,每个工具都有一步步的图文流程,跟着做就行。