零基础开发环境搭建教程（JDK17+Node.js+VS Code）

前言

这是编程入门的第一步，不用怕复杂 —— 全程跟着步骤点鼠标、输命令就行，我会把每个操作拆到 “点击第几个按钮” 的程度，遇到问题也有对应的解决方法。

核心目标：安装好三个工具，让系统能 “认得出” 它们（就是配置环境变量），最后用命令行确认安装成功。

一、先明确：我们要装什么？

工具	作用	难度	关键注意点
JDK17	运行 / 编译 Java 代码的核心工具	中等	必须手动配置环境变量
Node.js	运行 JavaScript/Node 代码的工具	简单	安装时勾选自动配置环境变量
VS Code	写代码的编辑器（颜值高、功能全）	简单	安装时勾选 “添加到 PATH”

二、第一步：安装 JDK17（最需要注意配置）

1. 下载 JDK17（免登录版，新手首选）

不用去 Oracle 官网（要登录），选开源免费的 Eclipse Temurin 版本：

1. 打开浏览器，输入地址：https://adoptium.net/zh-CN/temurin/releases/?version=17

2. 页面上选择：

   • 操作系统：Windows
   • 架构：x64（几乎所有电脑都是 64 位，不用改）
   • 安装包类型：选 .msi（安装包，双击就能装，比.zip 解压版简单）

3. 点击下载按钮，等待下载完成（文件大小约 150MB）。

2. 安装 JDK17（全程点下一步，记好安装路径）

1. 找到下载的 .msi 文件（通常在 “下载” 文件夹），双击打开。
2. 弹出 “用户账户控制”，点击「是」。
3. 安装向导页面：点击「Next」（下一步）。
4. 选择安装路径：记住这个路径！（默认是 C:\Program Files\Eclipse Adoptium\jdk-17.0.9.9-hotspot，可以直接用默认，不用改），继续点击「Next」。
5. 点击「Install」（安装），等待 1-2 分钟。
6. 安装完成后，点击「Finish」（完成）。

3. 配置 JDK 环境变量（关键！系统认得出 Java 的核心）

环境变量的作用：让你在电脑任何文件夹的命令行里，输入 java 都能找到这个工具，不用手动输长长的安装路径。

1. 右键点击桌面「此电脑」→ 选择「属性」（如果桌面没有 “此电脑”，打开文件资源管理器，左侧也能找到）。

2. 在弹出的页面里，点击右侧「高级系统设置」（往下滑能看到）。

3. 弹出 “系统属性” 窗口，点击「环境变量」按钮（右下角）。

4. 重点：在「系统变量」区域操作（不是上面的 “用户变量”）：

   • 第一步：新建 JAVA_HOME 变量

     点击「新建」→ 变量名填：JAVA_HOME → 变量值填你刚才记的 JDK 安装路径（比如 C:\Program Files\Eclipse Adoptium\jdk-17.0.9.9-hotspot）→ 点击「确定」。

   • 第二步：修改 Path 变量

     在系统变量里找到 Path → 点击「编辑」→ 点击「新建」→ 输入 %JAVA_HOME%\bin → 点击「上移」把这行放到最上面（避免和其他版本冲突）→ 点击「确定」。

5. 最后：把所有弹出的窗口都点「确定」关掉（一定要点到底，不能只关窗口！ 否则配置不生效）。

4. 验证 JDK 是否装成功（关键一步）

1. 按下键盘「Win+R」，输入 cmd，回车打开「命令提示符」（黑色窗口）。

2. 输入第一个命令：java -version → 回车。

   ✅ 成功样子：显示包含 “17” 的版本信息，比如：

   plaintext

   java version "17.0.9" 2023-10-17 LTS
   Java(TM) SE Runtime Environment Temurin-17.0.9+9 (build 17.0.9+9-LTS)
   

   ❌ 失败样子：提示「'java' 不是内部或外部命令，也不是可运行的程序」（说明环境变量没配对）。

3. 输入第二个命令：javac -version → 回车。

   ✅ 成功样子：显示 javac 17.0.9（和上面的版本一致）。

三、第二步：安装 Node.js（最简单，几乎不用配）

1. 下载 Node.js

1. 打开浏览器，输入地址：https://nodejs.org/zh-cn/download/
2. 选择「Windows 安装包 (.msi)」→ 下载「LTS 版本」（长期支持版，比如 20.x，稳定不闪退）。

2. 安装 Node.js（重点勾选一个选项）

1. 双击下载的 .msi 文件，弹出窗口点击「是」。
2. 安装向导：点击「Next」→ 勾选 “我接受协议”→ 「Next」→ 继续「Next」（路径默认就行）。
3. 关键步骤：看到「Add to PATH」选项（意思是 “添加到环境变量”），一定要勾选 → 继续「Next」。
4. 点击「Install」安装，等待 1 分钟 → 安装完成点击「Finish」。

3. 验证 Node.js 是否装成功

1. 打开新的命令提示符（之前的窗口关了重开，避免缓存）。

2. 输入第一个命令：node -v → 回车。

   ✅ 成功样子：显示版本号，比如 v20.10.0。

3. 输入第二个命令：npm -v → 回车。

   ✅ 成功样子：显示 npm 版本号，比如 10.2.3。

四、第三步：安装 VS Code（编辑器，颜值高还好用来）

1. 下载 VS Code

1. 打开浏览器，输入地址：https://code.visualstudio.com/Download
2. 选择「Windows」→ 下载 .exe 安装包。

2. 安装 VS Code（勾选 2 个关键选项）

1. 双击下载的 .exe 文件，点击「是」。

2. 安装向导：勾选「我同意协议」→ 「下一步」→ 路径默认就行→「下一步」。

3. 关键勾选项（新手必勾）：

   • 「添加到 PATH（重启后生效）」（让命令行能输 code 打开编辑器）；
   • 「注册为受支持的文件类型的编辑器」（双击代码文件能直接用 VS Code 打开）。

4. 点击「下一步」→「安装」→ 完成后点击「运行 Visual Studio Code」。

3. 验证 VS Code 是否装成功

验证方法 1（命令行）：

1. 关闭所有命令提示符，重新打开一个。

2. 输入 code -v → 回车。

   ✅ 成功样子：显示 VS Code 版本信息，比如：

   plaintext

   1.85.1
   0ee08df0cf4527e40edc9aa28f4b5bd38bbff2b2
   x64
   

验证方法 2（直接打开）：

双击桌面的 VS Code 图标，能正常打开编辑器界面，就说明装好了。

五、一次性验证所有工具（最终检查）

1. 打开新的命令提示符（Win+R → cmd）。

2. 依次输入以下命令，每输一个回车，都能显示对应版本就说明全部成功：

   bash

   运行

   # 验证JDK
   java -version
   javac -version
   # 验证Node.js
   node -v
   npm -v
   # 验证VS Code
   code -v
   

六、新手最常遇到的问题 & 解决方法

问题 1：输入 java -version 提示「不是内部命令」

原因：环境变量配错了 / 没重启命令行 / 没点确定保存。

解决：

1. 重新检查 JAVA_HOME 路径是否和安装路径一致（复制路径粘贴，避免手输错）；
2. 确认 Path 里加了 %JAVA_HOME%\bin；
3. 关闭所有命令行，重新打开再试；
4. 还不行就重启电脑（环境变量生效的终极方法）。

问题 2：Node.js 安装后 node -v 报错

原因：安装时没勾选「Add to PATH」。

解决：

1. 找到 Node.js 安装路径（默认 C:\Program Files\nodejs）；
2. 按 JDK 配置环境变量的方法，把这个路径加到系统变量的 Path 里；
3. 重启命令行再试。

问题 3：code -v 提示「不是内部命令」

原因：VS Code 安装时没勾选「添加到 PATH」。

解决：

1. 卸载 VS Code（控制面板→程序→卸载程序）；
2. 重新安装，务必勾选「添加到 PATH」；
3. 重启命令行。

七、总结（核心要点记下来）

1. JDK17：必须配置 JAVA_HOME，并把 %JAVA_HOME%\bin 加到 Path，验证用 java -version + javac -version；
2. Node.js：安装时勾选「Add to PATH」，验证用 node -v + npm -v；
3. VS Code：安装时勾选「添加到 PATH」，验证用 code -v 或直接打开界面；
4. 所有验证都要「重启命令行」，环境变量配置后一定要点「确定」保存。

装完这三个工具，你就有了最基础的 Java/JavaScript 开发环境，接下来可以用 VS Code 写第一行代码啦！