NetBeans 安装全教程
NetBeans 是一个功能强大的免费开源集成开发环境,特别适合 Java 开发,同时也支持 PHP、C/C++、HTML5 等多种语言,本教程将以最常用的 Java SE (标准版) 开发为例进行讲解。

(图片来源网络,侵删)
第一步:准备工作(重要!)
在开始安装之前,请务必完成以下准备工作,这是安装成功的关键。
下载并安装 Java Development Kit (JDK)
NetBeans 本身是用 Java 编写的,它需要一个 JDK 来运行和编译你写的 Java 代码。NetBeans 安装程序本身不包含 JDK。
如何检查和安装 JDK?
a) 检查是否已安装 JDK

(图片来源网络,侵删)
打开你的命令行工具(Windows 是 cmd 或 PowerShell,macOS/Linux 是 Terminal),输入以下命令:
java -version
- 如果显示版本信息(如
java version "17.0.2"),说明你已经安装了 JDK,请继续输入javac -version检查编译器是否也存在,如果两者都有,你可以跳过 JDK 安装步骤,直接进入第二步。 - 如果提示“不是内部或外部命令...”或“找不到命令”,说明你还没有安装 JDK 或环境变量没有配置正确,请继续下一步。
b) 下载并安装 JDK
- 访问官网:前往 Oracle 官方下载页面:Oracle JDK 下载页面
- 选择版本:选择一个 LTS (长期支持) 版本,JDK 17 或 JDK 21,这些版本更稳定,推荐使用。
- 选择操作系统:根据你的操作系统(Windows, macOS, Linux)下载对应的安装包。
- 安装:
- Windows: 双击
.msi文件,按照安装向导的提示进行安装。强烈建议保持默认安装路径(通常是C:\Program Files\Java\jdk-xx),这可以避免后续配置环境变量的麻烦。 - macOS: 下载
.dmg文件,双击打开,将 JDK 拖拽到Applications文件夹即可。 - Linux: 下载
.rpm(RedHat/CentOS) 或.deb(Ubuntu/Debian) 包,使用包管理器安装,sudo apt install ./jdk-xx_linux-x64.deb。
- Windows: 双击
c) 配置环境变量(如果需要)
-
Windows: 如果安装时没有自动配置环境变量,你需要手动配置。
(图片来源网络,侵删)- 右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
- 在“系统变量”中,新建
JAVA_HOME,变量值为你的 JDK 安装路径(C:\Program Files\Java\jdk-17.0.2)。 - 找到
Path变量,点击“编辑”,新建”,添加%JAVA_HOME%\bin。 - 保存所有窗口,然后重新打开命令行工具,再次运行
java -version和javac -version进行验证。
-
macOS/Linux: 通常安装后无需配置,因为安装包会自动处理,如果遇到问题,可以检查
~/.bash_profile或~/.zshrc文件中是否有相关的JAVA_HOME和PATH配置。
第二步:下载 NetBeans 安装包
- 访问官网:前往 NetBeans 官方下载页面:NetBeans 官方下载页面
- 选择版本:推荐下载最新的 Apache NetBeans 版本,它将 IDE 和 JDK 打包在一起,非常方便。
- 选择安装包:
- 对于初学者和 Java 开发者,直接下载 "Java SE" 版本即可,这个版本包含了运行 Java 应用所需的一切。
- 如果你需要开发 Web (Java EE)、PHP 或 C/C++ 项目,请下载对应的完整版或捆绑包。
- 下载文件:根据你的操作系统下载对应的安装包(Windows 通常是
.exe或.msi,macOS 是.dmg,Linux 是.sh脚本或.rpm/.deb包)。
第三步:安装 NetBeans
安装步骤因操作系统而异。
A. Windows 安装 (以 .exe 或 .msi 为例)
- 双击你下载的安装文件(
netbeans-xx-windows.exe)。 - 同意许可协议:勾选 "I accept the terms in the license agreement",然后点击 "Next"。
- 选择安装功能:
- 重要:确保 "Java Development Kit" 选项被勾选,如果它检测到你之前安装的 JDK,会自动为你选择,如果没有,它会尝试捆绑下载一个,你也可以手动指定你的 JDK 路径。
- 你还可以选择是否安装其他的捆绑插件,如 PHP, C/C++ 等。
- 选择安装目录:可以保持默认,也可以选择一个你喜欢的路径,点击 "Next"。
- 开始安装:点击 "Install",等待安装过程完成,这个过程会下载并解压一些文件,可能需要几分钟时间。
- 完成安装:安装完成后,点击 "Finish",此时可能会提示你重启电脑,建议重启以确保所有组件都正常工作。
B. macOS 安装 (以 .dmg 为例)
- 双击下载的
.dmg文件,它会挂载成一个虚拟磁盘。 - 打开虚拟磁盘,你会看到一个
NetBeans图标和一个Applications文件夹图标。 - 将 NetBeans 图标拖拽到
Applications文件夹图标中,完成安装。 - 安装后,你可以在
启动台或应用程序文件夹中找到 NetBeans 并打开它。
C. Linux 安装 (以 .sh 脚本为例)
- 打开终端,进入你下载
.sh文件的目录。 - 给脚本添加可执行权限:
chmod +x netbeans-xx.sh
- 运行安装脚本:
./netbeans-xx.sh
- 接下来会弹出图形化安装向导,与 Windows 类似,按照提示点击 "Next"、"同意"、"安装" 即可,如果命令行中没有图形界面,则需要先安装
X Window系统。
第四步:启动与配置
安装完成后,首次启动 NetBeans。
- 启动 NetBeans:从开始菜单或应用程序文件夹中启动 NetBeans。
- 选择用户目录:首次启动时,它会询问你选择一个用户配置目录,保持默认即可,点击 "OK"。
- 管理插件:启动后,建议检查插件更新,点击顶部菜单栏的 工具 -> 插件。
- 在 可用插件 标签页,你可以搜索并安装你需要的插件,Git 集成、Maven/Gradle 支持、主题美化插件等。
- 切换到 更新 标签页,检查并安装所有可用的更新。
第五步:创建你的第一个 Java 项目(Hello World)
这是验证安装是否成功的标准流程。
-
新建项目:
- 点击顶部菜单栏的 文件 -> 新建项目... (快捷键
Ctrl+Shift+N)。 - 在弹出的窗口中,选择 类别 -> Java,然后在 项目 中选择 Java 应用。
- 点击 下一步。
- 点击顶部菜单栏的 文件 -> 新建项目... (快捷键
-
配置项目:
- 项目名称:输入
HelloWorld。 - 项目位置:选择一个你用来存放代码的文件夹。
- 创建主类:勾选此项,并在旁边的输入框中输入
com.example.HelloWorld,NetBeans 会自动创建包com.example和类HelloWorld。 - 点击 完成。
- 项目名称:输入
-
编写代码:
- NetBeans 会自动为你生成一个
HelloWorld.java文件,并包含一个main方法。 - 在
main方法中,输入以下代码:System.out.println("Hello, NetBeans!");
- NetBeans 会自动为你生成一个
-
运行项目:
- 点击工具栏上的绿色 运行 按钮(一个三角形图标)。
- 或者右键点击项目窗口中的
HelloWorld.java文件,选择 运行文件。 - 或者使用快捷键
F6。
-
查看结果:
- 在 NetBeans 窗口的底部,会出现一个 输出 窗口,你会看到打印出的内容:
Hello, NetBeans! 构建成功 (总时间: 0 秒)
- 在 NetBeans 窗口的底部,会出现一个 输出 窗口,你会看到打印出的内容:
如果看到了这个输出,恭喜你!NetBeans 已经成功安装并配置好了!
常见问题与解决方法
-
问题:启动 NetBeans 时提示 "JDK not found" 或 "无法找到 JDK"。
- 解决:说明 JDK 没有安装或 NetBeans 没有找到它,请返回 第一步,确保 JDK 已正确安装,并且环境变量
JAVA_HOME和PATH配置正确,在 NetBeans 的工具->选项->Java中,也可以手动设置 JDK 主目录。
- 解决:说明 JDK 没有安装或 NetBeans 没有找到它,请返回 第一步,确保 JDK 已正确安装,并且环境变量
-
问题:新建项目时没有 "Java" 选项。
- 解决:说明你在安装时没有选择 Java 开发组件,请重新运行安装程序,确保勾选了 "Java Development Kit" 或 "Java SE"。
-
问题:代码提示和代码补全不工作。
- 解决:检查
工具->选项->编辑器->代码补全,确保相关选项已启用,有时重启 NetBeans 也能解决。
- 解决:检查
希望这份详细的教程能帮助你顺利安装并开始使用 NetBeans!祝你编码愉快!
