`

STEP 1

先弄懂 2 个核心概念

这两个词搞懂了,"配环境"就不再神秘

代码运行环境

代码写完只是一堆文字,需要一个专门的程序把它跑起来。JavaScript 代码要有 Node.js 才能在电脑上执行,Python 代码要有 Python 才能跑。没有对应的运行环境,代码就只是个文本文件。

类比:安卓的 App 装不进 Windows,Windows 的软件也跑不了安卓——不同代码需要对应的运行环境才能执行

包管理器(Package Manager)

开发者写好的代码工具库,叫"包"或"依赖"。包管理器帮你一键下载、安装、管理这些工具。Node.js 用 npm/pnpm,Python 用 pip,不用自己去各个网站手动下载。

类比:App Store,想要什么功能,搜一下一键安装

一句话总结"编程环境"是什么

编程环境 = 代码运行环境(让代码能跑)+ 包管理器(管理依赖)。两样配齐,代码就能跑起来。

STEP 2

你需要安装哪些运行时?

按需装,不需要全装;每个装好后用验证命令确认

Node.js

前端必装

推荐版本:LTS v22

包管理:npm / pnpm / yarn

做网站、小程序、App 都离不开它。你用 AI 生成的项目代码,绝大多数都需要先装 Node.js 才能跑起来——它就是让这些项目在你电脑上"活起来"的基础程序。装好之后自带 npm 包管理器,可以一键安装项目所需的各种工具包。

node -v — 装好后运行验证

适合场景

做网站 / 小程序 / 全栈 App

Python

AI 项目必装

推荐版本:3.12+

包管理:pip / uv / conda

AI、数据处理、FastAPI 后端的首选语言。调用大模型 API、跑机器学习脚本都要用。不做 AI 或数据相关项目可以跳过,但做了就绕不开。

python -V — 装好后运行验证

适合场景

AI 应用 / 数据分析 / 后端 API

Git

所有项目必装

推荐版本:2.x

包管理:(无包管理器)

代码版本管理工具。克隆项目模板、保存每次改动、多人协作、部署到 Vercel/Railway 都要用到它。装了 Git 才能用 GitHub,才能一键 push 上线。

git -v — 装好后运行验证

适合场景

所有项目,无例外

Java / JDK

按需安装

推荐版本:JDK 21 LTS

包管理:Maven / Gradle

Android 开发和 Spring Boot 后端的基础。装完需要配置 JAVA_HOME 环境变量。不做 Android 或 Java 后端可以跳过,不影响其他项目。

java -version — 装好后运行验证

适合场景

Android 开发 / Spring Boot

推荐安装顺序

  1. 1. Git — 最先装,后面克隆项目要用
  2. 2. Node.js — 大多数 Web 项目的基础
  3. 3. Python — 做 AI 应用再装
  4. 4. Java/JDK — 做 Android 或 Java 后端再装

每装完一个,打开终端跑一下验证命令,看到版本号就说明装好了。

STEP 3

环境配置最常见的 5 个坑

遇到问题,对照这里先查一遍

"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

配环境的核心心法

  • · 安装完一定要重启终端,让 PATH 生效
  • · 每步装完就用验证命令(如 node -v)确认
  • · 遇到报错直接把错误信息丢给 AI,九成都能解决
  • · 环境只需装一次,以后所有项目共用

搞懂概念了,下一步去动手装

学习路径里找对应的安装教程,每个工具都有一步步的图文流程,跟着做就行。