NetBeans 安装全攻略（图文详解）

NetBeans 是一个功能强大的免费开源集成开发环境，尤其擅长 Java 开发，同时也支持 PHP、C/C++、HTML5 等多种语言，本教程将引导你一步步完成 NetBeans 的安装和配置。

第一步：准备工作（重要！）

在开始安装之前,请务必完成以下准备工作，这是确保 NetBeans 能够正常运行的关键。

安装 Java Development Kit (JDK)

NetBeans 本身是一个 Java 应用程序，它需要一个 JDK 来编译和运行你编写的 Java 程序。必须先安装 JDK。

如何检查是否已安装 JDK？ 打开命令行工具（Windows 是 cmd 或 PowerShell，macOS/Linux 是 Terminal），输入以下命令：

java -version
javac -version

• 如果两行都显示了版本号（java version "17.0.2"），说明你已经安装了 JDK，并且版本符合要求，可以跳过此步骤，直接进行第二步。
• 如果提示“不是内部或外部命令”或找不到命令，说明你没有安装 JDK，或者环境变量没有配置正确，请务必先安装 JDK。

如何安装 JDK？

推荐使用 Oracle OpenJDK 或 Adoptium (Eclipse Temurin)，它们都是官方、稳定且免费的选择。

推荐下载地址：

• Adoptium (Eclipse Temurin): https://adoptium.net/ (社区驱动，更新快，推荐首选)
• Oracle OpenJDK: https://jdk.java.net/ (Oracle 官方)

安装步骤（以 Adoptium 为例）：

1. 访问 Adoptium 官网。
2. 点击 "Download" 按钮。
3. 选择你的操作系统（Windows, macOS, Linux）。
4. 选择 JDK 版本，对于新手，推荐选择最新的 LTS (Long Term Support) 版本，JDK 17 或 JDK 21。
5. 下载安装包（.msi 文件）。
6. 双击安装包,按照向导进行安装。Windows 用户建议勾选 "Set JAVA_HOME and PATH variables" 选项，这样可以自动配置环境变量，省去很多麻烦。
7. 安装完成后,再次打开命令行输入 java -version 和 javac -version，确认安装成功。

第二步：下载 NetBeans 安装包

准备工作就绪后,我们来下载 NetBeans 安装程序。

1. 访问 NetBeans 官网下载页面： https://netbeans.apache.org/download/

2. 选择安装包：

   • 在页面中,你会看到 "Java SE" 和 "All" 等选项。
   • Java SE: 如果你主要进行 Java SE (桌面应用、小工具) 开发，下载这个即可，体积较小。
   • All (PHP, Java SE, Web, etc.): 如果你需要开发 Web 应用、PHP 项目等，请下载这个 "All" 版本，它包含了所有支持的语言模块。
   • 根据你的需求,点击对应的链接下载，通常推荐下载 "All" 版本。

3. 选择操作系统：

   • 在下载页面,选择你的操作系统（Windows, macOS, Linux）。
   • 你会看到 "Installer" 和 "Zip" 两种格式。
     • Installer (推荐): 一个可执行安装程序，会引导你完成安装，并自动配置环境变量，非常方便。
     • Zip: 一个压缩包，解压后即可使用，但需要手动配置环境变量（设置 NETBEANS_HOME 和 PATH）。

第三步：安装 NetBeans

这一步根据你的操作系统和下载的安装包类型有所不同。

A. Windows 安装 (以 .msi 安装包为例)

1. 找到你下载的 .msi 文件（netbeans-23-ml-windows.exe），双击运行。
2. 欢迎界面: 点击 "Next"。
3. 选择安装位置: 默认位置是 C:\Program Files\NetBeans XX，如果你想更改，点击 "Browse"，通常保持默认即可，点击 "Next"。
4. 选择 JDK: 这是最关键的一步！ NetBeans 需要知道你安装的 JDK 在哪里。
   • 如果你在第一步安装 JDK 时勾选了自动配置环境变量，NetBeans 通常会自动检测到并显示在列表中。
   • 如果列表为空或没有显示正确的 JDK，点击 "Add..."，然后手动浏览到你 JDK 的安装目录（C:\Program Files\Java\jdk-17）。
   • 确保选择的路径是 JDK 的根目录，而不是 JRE 的目录！
5. 选择安装模块: 如果你下载的是 "All" 版本，这里会列出所有可用的模块（Java, PHP, Web, C/C++ 等），你可以根据需要勾选或取消勾选，点击 "Next"。
6. 准备安装: 检查摘要信息，无误后点击 "Install"。
7. 安装完成: 等待安装进度条走完，点击 "Finish"。

B. macOS 安装 (以 .dmg 安装包为例)

1. 双击下载的 .dmg 文件，它会挂载成一个虚拟磁盘。
2. 打开虚拟磁盘,你会看到一个 NetBeans 图标。将它拖拽到 "Applications" (应用程序) 文件夹中，这就是安装过程。
3. 安装完成后,可以安全地弹出虚拟磁盘。
4. 配置 JDK (重要):
   • 打开 "终端" (Terminal)。
   • 输入以下命令来查找 JDK 的安装路径：

     /usr/libexec/java_home -V

   • 你会看到类似下面的输出,找到你安装的 JDK 版本，Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home。
   • 打开 NetBeans，它通常会自动检测到 JDK，如果没有，你可以在 NetBeans 的菜单栏中选择 NetBeans > Preferences... (在 macOS 上)，然后在弹出的窗口中导航到 Java > JDKs，点击 "Add JDK..."，然后手动选择上一步找到的 JDK 路径。

C. Linux 安装 (以 .sh 安装脚本为例)

1. 打开终端。
2. 给安装脚本添加可执行权限：

   chmod +x netbeans-23.sh

3. 运行安装脚本：

   ./netbeans-23.sh

4. 接下来会弹出图形化安装界面（如果你的系统支持），或者是一个基于文本的界面，按照提示操作即可。
   • 选择 JDK: 安装程序会尝试自动检测 JDK，如果检测失败，你需要手动输入 JDK 的安装路径（/usr/lib/jvm/java-17-openjdk-amd64）。
   • 选择安装模块: 类似 Windows 版本，你可以选择需要的语言支持。
   • 完成安装: 安装程序通常会将 NetBeans 安装到 /usr/local/netbeans-xx 目录，并创建一个桌面快捷方式。

第四步：启动和验证安装

1. 启动 NetBeans:

   • Windows: 从 "开始" 菜单找到 "NetBeans" 并点击。
   • macOS: 从 "应用程序" 文件夹中找到并双击 "NetBeans"。
   • Linux: 通常可以在应用程序菜单中找到，或者在终端中输入 netbeans 命令启动。

2. 首次启动:

   • 首次启动时,NetBeans 可能会进行一些初始化设置，请稍等片刻。
   • 它可能会提示你选择一个主题（外观），选择你喜欢的即可。

3. 创建一个测试项目来验证:

   1. 启动后,点击 "File" -> "New Project"。
   2. 在 "Categories" 中选择 "Java"，在 "Projects" 中选择 "Java Application"，然后点击 "Next"。
   3. 为你的项目命名（HelloWorld），选择项目存放位置，确保 "Set as Main Project" 和 "Create Main Class" 都被勾选。
   4. 点击 "Finish"。
   5. NetBeans 会自动生成一个 HelloWorld.java 文件，并包含一个 main 方法。
   6. 在 main 方法中，输入以下代码：

      System.out.println("Hello, NetBeans!");

   7. 右键点击项目名称,选择 "Run"。
   8. 如果在窗口底部的 "Output" 区域看到了 Hello, NetBeans! 的输出，并且没有报错，那么恭喜你，NetBeans 已经成功安装并配置完毕！

常见问题与解决

• 问题: 启动 NetBeans 时提示 "JDK not found" 或类似错误。

  • 解决: 这说明 NetBeans 没有找到正确的 JDK，请回到第三步，仔细检查 JDK 的路径配置是否正确，确保路径指向的是 JDK 的根目录（包含 bin, lib, jre 等文件夹的目录）。

• 问题: 运行项目时提示 "Error: Could not find or load main class"。

  • 解决: 这通常是项目配置问题，检查项目的 "Sources" 文件夹是否包含你的主类文件，"Build" -> "Clean and Build" 项目一次，然后再运行。

• 问题 (Windows): 环境变量配置失败。

  • 解决: 手动配置，右键 "此电脑" -> "属性" -> "高级系统设置" -> "环境变量"，在 "系统变量" 中：
    • 新建 JAVA_HOME，值为你的 JDK 安装路径（如 C:\Program Files\Java\jdk-17）。
    • 编辑 Path 变量，新建 %JAVA_HOME%\bin。

• 问题 (Linux/macOS): 无法通过终端启动 NetBeans。

  • 解决: 确保安装脚本将 NetBeans 的 bin 目录添加到了系统的 PATH 环境变量中，如果没有，可以手动添加，或者直接使用图形界面启动。

希望这份详细的教程能帮助你顺利完成 NetBeans 的安装！祝你编码愉快！