企业官网建设流程全解析

1. 项目概述：一个能真正“看见”网络连接状态的Java端口扫描工具

你有没有遇到过这样的场景：在本地调试一个Web服务，浏览器死活打不开localhost:8080；或者部署完数据库，应用日志里反复报“Connection refused”；又或者帮同事排查远程服务器连通性，ping通了但telnet就是连不上——这时候你最需要的，不是一句“网络应该没问题”，而是一个能快速告诉你“80端口开着但3306被防火墙挡了”的可视化工具。这个标题“java实现端口扫描设计UI界面”，说的正是这样一个东西：它不是教科书里的理论Demo，而是一个能装进U盘、双击就跑、输入IP和端口范围就能出结果的实用小工具。核心关键词是Java端口扫描、Swing UI界面、TCP连接探测、网络连通性诊断。它解决的是开发、运维、测试甚至网管日常中最琐碎却最耗时的问题——确认目标机器上哪些端口是真实可访问的。适合三类人：刚学完Java网络编程想落地练手的新手，需要快速验证服务部署状态的后端开发者，以及不熟悉命令行但又要处理基础网络问题的技术支持人员。我做过不下二十个类似的小工具，从纯命令行到Web版再到Electron打包，最后发现——对绝大多数一线场景来说，一个轻量、无依赖、带图形界面的Java桌面程序，反而是最稳、最快、最不容易出幺蛾子的选择。它不追求炫酷动画，只求一次点击，三秒出结果，绿色免安装，关机重启后还能用。

2. 整体设计思路与技术选型逻辑

2.1 为什么是Java？而不是Python或Go？

很多人第一反应是：“端口扫描用Python写几行socket.connect()不就完了？为啥还要搞Java？”这问题问得特别实在，也恰恰是设计起点。我们来算一笔账：Python确实快，nmap脚本一写就跑，但它的“快”是开发快，不是交付快。你打包成exe给客户，动辄50MB起步，还常因PyInstaller版本兼容性导致运行报错；Go编译出来是单文件，但Windows下默认会弹UAC权限提示，普通用户看到“是否允许此应用对设备进行更改”就懵了。而Java呢？JRE在99%的开发机、测试机、甚至很多生产服务器上早已预装。你只需要一个不到200KB的jar包，双击即启，不弹任何系统警告，所有UI渲染、线程调度、异常捕获都由JVM兜底。我曾在一个某高校实验室的老旧Windows 7机器上部署过同类工具——那台机器连Chrome都打不开，但Java 8 JRE还在跑着几个教学用的Applet，我们的扫描工具照样丝滑运行。这不是技术情怀，是现实妥协后的最优解：交付成本最低，用户门槛最低，故障面最小。

2.2 为什么用Swing，而不是JavaFX或Web界面？

标题明确写了“设计UI界面”，这就排除了纯控制台方案。那为什么选Swing？先说结论：Swing是Java生态里唯一一个“写一次，到处能看懂”的GUI框架。JavaFX虽然更现代，但自Java 11起就被移出JDK标准库，你得额外打包javafx.controls.jar等一堆依赖，稍有不慎就ClassNotFoundException；Web界面（比如用Spring Boot + Thymeleaf）看似时髦，但要开HTTP服务、配端口、防跨域，一个简单扫描工具硬生生变成微型Web服务器，安全审计时还得解释“为啥要开8081端口”。而Swing呢？它是JDK自带的，从Java 1.2活到今天，所有组件源码公开，文档齐全，连JTable怎么自定义单元格渲染器都有十几种成熟方案。更重要的是，它的线程模型极其清晰：所有UI操作必须在Event Dispatch Thread（EDT）中执行。这反而成了优势——当你启动扫描线程时，UI不会卡死，进度条能实时刷新，按钮能及时置灰/恢复，这种确定性，在复杂异步场景下比“看起来高级”的框架更可靠。我试过用JavaFX重写同一套逻辑，光是解决Platform.runLater()和后台线程数据同步就多花了两天，最后效果和Swing并无二致。所以，选Swing不是守旧，是用最可控的工具，做最不可控的事（网络IO）。

2.3 扫描策略：为什么只做TCP Connect扫描，不做SYN扫描？

标题没限定扫描类型，但实际实现中，我们必须做取舍。网络层有两类主流扫描：SYN扫描（半开扫描）和TCP Connect扫描（全连接扫描）。SYN扫描效率高、隐蔽性强，但它需要原始套接字（Raw Socket），在Windows上需管理员权限，在Linux上需CAP_NET_RAW能力，普通用户双击运行直接失败。而TCP Connect扫描呢？它调用的是操作系统标准的connect()系统调用，只要用户有网络权限（这几乎是默认的），就能跑。它的缺点是速度慢一点、会在目标机器留下连接日志，但对于内网诊断、本地服务验证这类场景，日志根本不是问题，而“能不能跑起来”才是生死线。实测数据：在局域网内扫描1-1000端口，TCP Connect平均耗时4.2秒，SYN扫描理论快3倍，但加上权限检查、异常降级逻辑，最终代码量翻倍，稳定性反而下降。所以，我们选择牺牲理论性能，换取100%的可用性。这也是为什么所有商业级网络诊断工具（如SolarWinds Ping Sweep）的免费版，默认都是TCP Connect——因为用户要的是结果，不是论文分数。

2.4 架构分层：三层分离，让代码像乐高一样可替换

整个程序按职责划分为清晰三层：

• UI层（View）：纯Swing组件，只负责展示、接收用户输入（IP、端口范围、扫描按钮），不碰任何网络逻辑。所有事件监听器（如ActionListener）只做一件事：把输入参数打包，扔给Controller。
• 控制层（Controller）：这是心脏。它接收UI参数，校验合法性（比如IP格式、端口范围是否越界），然后创建并启动扫描任务线程。关键点在于：它用SwingWorker封装后台任务，确保doInBackground()里跑耗时扫描，done()里更新UI，完美避开Swing线程安全陷阱。
• 模型层（Model）：包含PortScanner核心类，它只干一件事——给定一个IP和端口，返回PortStatus枚举（OPEN/CLOSED/FILTERED/TIMEOUT）。这个类完全独立于UI，你可以把它抽出来，写个JUnit测试，或者集成进Spring Boot的REST接口里，零改造成本。

这种分层不是为了炫技，是为后续扩展留活路。比如，某天你想加UDP扫描，只需新增一个UdpPortScanner实现类，Controller里加个判断分支，UI层几乎不用动；再比如，你想把结果导出为Excel，只用在Controller的done()方法里加几行Apache POI代码，UI层连重绘都不需要。我见过太多把connect()直接写在button.addActionListener()里的Demo，改一行代码，整个UI线程就卡死——那不是工具，是定时炸弹。

3. 核心细节解析与实操要点

3.1 IP与端口范围校验：别让错误输入毁掉第一印象

UI界面再漂亮，输错IP地址或端口范围，点开始就报红错，用户体验直接归零。所以，校验不是锦上添花，是底线。我们分两步做：

第一步：IP地址格式强校验
不能只用正则^((25[0-5]|2[0-4]\\d|[01]?\\d\\d?)\\.){3}(25[0-5]|2[0-4]\\d|[01]?\\d\\d?)$。这正则能匹配999.999.999.999，因为25[0-5]部分没限制首位不能为0。正确做法是：用InetAddress.getByName(ipString)尝试解析，捕获UnknownHostException。这个方法底层会做完整语义校验，比如127.0.0.1合法，127.0.0.256直接抛异常。代码片段如下：

private boolean isValidIP(String ip) { try { InetAddress.getByName(ip); return true; } catch (UnknownHostException e) { return false; } }

为什么不用Inet4Address？因为我们要兼容IPv6，getByName自动识别，而Inet4Address强制IPv4，::1这种本地回环v6地址就挂了。

第二步：端口范围逻辑校验
用户可能输入1-65535，也可能手抖输成65535-1，甚至abc-def。校验逻辑必须覆盖：

• 起始端口和结束端口必须是数字；
• 起始端口 ≤ 结束端口；
• 端口号必须在1-65535范围内（0是保留端口，65536溢出）。

这里有个易错点：Integer.parseInt()遇到非数字字符串会抛NumberFormatException，但如果你在try-catch里只捕获这个异常，而忘了处理null输入（比如用户清空了文本框），就会NullPointerException。所以，完整校验函数要先判空：

private boolean isValidPortRange(String startStr, String endStr) { if (startStr == null || endStr == null || startStr.trim().isEmpty() || endStr.trim().isEmpty()) { return false; } try { int start = Integer.parseInt(startStr.trim()); int end = Integer.parseInt(endStr.trim()); return start >= 1 && end <= 65535 && start <= end; } catch (NumberFormatException e) { return false; } }

这个函数返回false时，UI必须给出明确提示，比如"端口范围无效：请输入1-65535之间的整数，且起始端口不能大于结束端口"，而不是笼统的“输入错误”。

3.2 扫描线程管理：如何避免“点十次，扫十次”的灾难

UI按钮点击事件里，如果直接new Thread(() -> scan()).start()，用户狂点十次，后台就起十个线程同时扫同一个IP，CPU飙升，结果混乱，还可能触发目标机器的连接限制。必须做线程节流。我们用SwingWorker，它天然支持取消和状态监听。关键代码结构：

private SwingWorker<Void, PortScanResult> currentWorker; private void startScan() { // 如果已有扫描在运行，先取消 if (currentWorker != null && !currentWorker.isDone()) { currentWorker.cancel(true); // 可选：重置UI状态，如按钮文字变回"开始扫描" scanButton.setText("开始扫描"); } // 创建新Worker currentWorker = new PortScanWorker(ip, startPort, endPort); currentWorker.addPropertyChangeListener(evt -> { if ("state".equals(evt.getPropertyName())) { SwingWorker.StateValue state = (SwingWorker.StateValue) evt.getNewValue(); if (state == SwingWorker.StateValue.STARTED) { scanButton.setText("正在扫描..."); scanButton.setEnabled(false); } else if (state == SwingWorker.StateValue.DONE) { scanButton.setText("开始扫描"); scanButton.setEnabled(true); } } }); currentWorker.execute(); }

这里有两个精妙设计：一是cancel(true)会中断线程，但Socket.connect()本身是阻塞IO，中断不一定立即生效，所以我们在PortScanner的scanPort方法里，必须配合Thread.interrupted()做主动退出：

public PortStatus scanPort(String ip, int port, int timeoutMs) { Socket socket = null; try { socket = new Socket(); // 设置连接超时，避免卡死 socket.connect(new InetSocketAddress(ip, port), timeoutMs); return PortStatus.OPEN; } catch (IOException e) { if (Thread.currentThread().isInterrupted()) { return PortStatus.CANCELLED; // 自定义状态 } // 根据异常类型判断 if (e instanceof SocketTimeoutException) { return PortStatus.TIMEOUT; } else if (e.getMessage().toLowerCase().contains("connection refused")) { return PortStatus.CLOSED; } else { return PortStatus.FILTERED; } } finally { if (socket != null && !socket.isClosed()) { try { socket.close(); } catch (IOException ignored) {} } } }

二是PropertyChangeListener监听state属性，动态更新按钮文字和状态。这样，用户点一次，UI立刻反馈“正在扫描”，再点无效，体验干净利落。

3.3 连接超时与并发控制：速度与稳定的平衡术

扫描速度取决于两个参数：单个端口的connect()超时时间，和同时扫描的端口数量（并发度）。设得太短，丢包率高的网络会把开放端口误判为TIMEOUT；设得太长，扫1000个端口要等十几分钟。并发度同理：开100个线程一起扫，局域网飞快，但扫公网IP可能被目标防火墙限速甚至拉黑。

我们采用自适应策略：

• 超时时间：默认设为2000ms（2秒）。这是经验值——内网延迟通常<10ms，公网骨干网<50ms，2秒足够覆盖99%的正常响应。如果用户勾选“快速模式”，则降为500ms，牺牲少量准确性换速度；勾选“精准模式”，升至5000ms，专治高延迟链路。
• 并发度：固定为10。为什么是10？因为Socket对象创建和销毁有开销，线程切换也有成本。实测数据：并发1→5，耗时线性下降；5→10，下降趋缓；10→20，耗时几乎不变，但内存占用翻倍。10是个甜点值，兼顾速度与资源。

核心扫描循环代码：

// 使用ExecutorService控制并发 private final ExecutorService executor = Executors.newFixedThreadPool(10); public List<PortScanResult> scanRange(String ip, int startPort, int endPort, int timeoutMs) { List<Future<PortScanResult>> futures = new ArrayList<>(); for (int port = startPort; port <= endPort; port++) { final int currentPort = port; Future<PortScanResult> future = executor.submit(() -> { PortStatus status = scanner.scanPort(ip, currentPort, timeoutMs); return new PortScanResult(currentPort, status); }); futures.add(future); } // 收集结果，支持中断 List<PortScanResult> results = new ArrayList<>(); for (Future<PortScanResult> future : futures) { try { if (Thread.currentThread().isInterrupted()) { break; } results.add(future.get(10, TimeUnit.SECONDS)); // 防止单个future卡死 } catch (InterruptedException | ExecutionException | TimeoutException e) { // 记录异常，但不中断整个扫描 } } return results; }

注意future.get(10, TimeUnit.SECONDS)的超时，这是第二道保险——即使scanPort内部没响应，外部也会强制超时，防止整个扫描队列被一个坏端口拖垮。

3.4 UI渲染优化：让上千行扫描结果不卡死

扫描结果少时，JTable直接塞数据没问题。但扫1-65535全端口，6万+行，DefaultTableModel往里addRow()，UI直接冻结10秒。必须用懒加载+分页。我们不真的一次性加载所有数据，而是：

• 后台扫描时，结果存入ConcurrentLinkedQueue<PortScanResult>；
• JTable绑定一个自定义TableModel，它只维护当前可视区域的几百行数据；
• 滚动时，TableModel动态从队列里取数据填充。

但这样太重。更轻量的方案是：扫描完成后，只显示前100个开放端口，其余状态汇总成统计卡片。UI上放一个JTabbedPane，左边是JTable（只显示OPEN端口），右边是JPanel堆叠的统计卡片（OPEN: 23个,CLOSED: 1200个,TIMEOUT: 5个）。JTable的数据源用DefaultTableModel，但只addRow()那些OPEN的结果。代码极简：

private void updateResultTable(List<PortScanResult> results) { DefaultTableModel model = (DefaultTableModel) resultTable.getModel(); model.setRowCount(0); // 清空 for (PortScanResult r : results) { if (r.getStatus() == PortStatus.OPEN) { model.addRow(new Object[]{r.getPort(), r.getStatus().getDesc()}); } } }

这样，哪怕扫6万个端口，JTable最多显示几百行，UI永远流畅。用户真要查某个特定端口，加个搜索框，JTable自带TableRowSorter，一行代码搞定过滤。

4. 实操过程与核心环节实现

4.1 从零搭建项目结构：Maven依赖与目录规划

我们用Maven管理依赖，pom.xml核心配置如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.example</groupId> <artifactId>port-scanner-ui</artifactId> <version>1.0-SNAPSHOT</version> <packaging>jar</packaging> <properties> <maven.compiler.source>11</maven.compiler.source> <maven.compiler.target>11</maven.compiler.target> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties> <dependencies> <!-- JavaFX不是必需的，这里不引入 --> <!-- 所有Swing和网络功能，JDK自带，无需额外依赖 --> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jar-plugin</artifactId> <version>3.3.0</version> <configuration> <archive> <manifest> <mainClass>com.example.scanner.MainFrame</mainClass> <addClasspath>true</addClasspath> </manifest> </archive> </configuration> </plugin> </plugins> </build> </project>

注意：没有添加任何第三方依赖。Swing、java.net、java.util.concurrent全是JDK标准库。项目目录结构极简：

src/ ├── main/ │ ├── java/ │ │ └── com/example/scanner/ │ │ ├── MainFrame.java // 主窗口入口 │ │ ├── controller/ // Controller层 │ │ │ └── ScanController.java │ │ ├── model/ // Model层 │ │ │ ├── PortScanner.java │ │ │ ├── PortStatus.java │ │ │ └── PortScanResult.java │ │ └── view/ // View层 │ │ └── ScannerPanel.java │ └── resources/ // 图标、配置等 └── test/ // 单元测试

这种结构，新人拉下代码，mvn clean package，生成的target/port-scanner-ui-1.0-SNAPSHOT.jar双击就运行，毫无障碍。

4.2 主窗口（MainFrame）实现：Swing的“Hello World”式严谨

MainFrame继承JFrame，但绝不只是setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE)了事。它要处理窗口生命周期：

public class MainFrame extends JFrame { private ScannerPanel mainPanel; public MainFrame() { setTitle("Java端口扫描器 v1.0"); setDefaultCloseOperation(JFrame.DO_NOTHING_ON_CLOSE); // 关键！ addWindowListener(new WindowAdapter() { @Override public void windowClosing(WindowEvent e) { // 询问用户是否退出，避免扫描中误关 int result = JOptionPane.showConfirmDialog( MainFrame.this, "扫描正在进行中，确定要退出吗？", "确认退出", JOptionPane.YES_NO_OPTION ); if (result == JOptionPane.YES_OPTION) { System.exit(0); } } }); mainPanel = new ScannerPanel(); add(mainPanel); // 设置窗口大小和居中 pack(); // 先pack，让组件计算最佳尺寸 setLocationRelativeTo(null); // 居中 setMinimumSize(new Dimension(600, 400)); // 设最小尺寸，防缩太小 setVisible(true); } public static void main(String[] args) { // Swing线程安全：所有UI操作必须在EDT中 SwingUtilities.invokeLater(MainFrame::new); } }

这里三个细节决定专业度：

1. setDefaultCloseOperation(JFrame.DO_NOTHING_ON_CLOSE)：禁用默认关闭，自己接管，避免用户扫到一半点叉号，进程没了但线程还在后台跑，造成资源泄漏。
2. WindowAdapter里windowClosing事件中，用JOptionPane二次确认，且只在扫描进行中才弹——这需要ScanController暴露一个isScanning()方法供查询。
3. SwingUtilities.invokeLater()包裹构造函数，确保MainFrame实例化在EDT中，这是Swing铁律，跳过它，某些UI组件（如JProgressBar）可能渲染异常。

4.3 扫描面板（ScannerPanel）布局：用GridBagLayout拿捏像素级精准

Swing布局管理器里，BorderLayout太粗放，FlowLayout太随意，GridLayout太死板。GridBagLayout是唯一能精确控制每个组件位置、大小、对齐的方案。ScannerPanel布局如下：

+---------------------------------------------------+ | [IP地址:] [127.0.0.1] | | [端口范围:] [1] - [1000] | | [ ] 快速模式 [ ] 精准模式 [开始扫描] [停止] | | | | +-----------------------------------------------+ | | | 开放端口列表 | | | | Port | Status | | | | |------|--------| | | | | 22 | OPEN | | | | | ... | ... | | | | +-----------------------------------------------+ | | [统计: OPEN: 3, CLOSED: 997, TIMEOUT: 0] | +---------------------------------------------------+

对应代码（精简版）：

public class ScannerPanel extends JPanel { private JTextField ipField; private JTextField startPortField; private JTextField endPortField; private JCheckBox fastModeBox; private JCheckBox accurateModeBox; private JButton startButton; private JButton stopButton; private JTable resultTable; private JLabel statusLabel; public ScannerPanel() { setLayout(new GridBagLayout()); GridBagConstraints gbc = new GridBagConstraints(); // IP行 gbc.gridx = 0; gbc.gridy = 0; gbc.anchor = GridBagConstraints.WEST; add(new JLabel("IP地址:"), gbc); gbc.gridx = 1; gbc.fill = GridBagConstraints.HORIZONTAL; gbc.weightx = 1.0; ipField = new JTextField("127.0.0.1", 15); add(ipField, gbc); // 端口范围行 gbc.gridy = 1; gbc.gridx = 0; gbc.fill = GridBagConstraints.NONE; gbc.weightx = 0; add(new JLabel("端口范围:"), gbc); gbc.gridx = 1; gbc.fill = GridBagConstraints.NONE; startPortField = new JTextField("1", 5); add(startPortField, gbc); gbc.gridx = 2; add(new JLabel("-"), gbc); gbc.gridx = 3; endPortField = new JTextField("1000", 5); add(endPortField, gbc); // 模式与按钮行 gbc.gridy = 2; gbc.gridx = 0; gbc.gridwidth = 2; fastModeBox = new JCheckBox("快速模式"); add(fastModeBox, gbc); gbc.gridx = 2; gbc.gridwidth = 1; accurateModeBox = new JCheckBox("精准模式"); add(accurateModeBox, gbc); gbc.gridx = 3; gbc.fill = GridBagConstraints.NONE; gbc.weightx = 0; startButton = new JButton("开始扫描"); add(startButton, gbc); gbc.gridx = 4; stopButton = new JButton("停止"); add(stopButton, gbc); // 结果表格 gbc.gridy = 3; gbc.gridx = 0; gbc.gridwidth = 5; gbc.fill = GridBagConstraints.BOTH; gbc.weighty = 1.0; String[] columns = {"端口", "状态"}; resultTable = new JTable(new DefaultTableModel(columns, 0)); JScrollPane scrollPane = new JScrollPane(resultTable); add(scrollPane, gbc); // 统计标签 gbc.gridy = 4; gbc.fill = GridBagConstraints.NONE; gbc.weighty = 0; statusLabel = new JLabel("准备就绪"); add(statusLabel, gbc); // 初始化事件监听 initEventListeners(); } private void initEventListeners() { startButton.addActionListener(e -> { // 触发扫描逻辑 }); stopButton.addActionListener(e -> { // 触发取消逻辑 }); } }

GridBagLayout的gbc.weightx和gbc.weighty控制组件拉伸权重，gbc.fill控制填充方式，gbc.gridwidth控制跨列。这套代码，无论窗口怎么拉伸，IP输入框始终占宽，按钮始终右对齐，表格始终填满剩余空间——这才是专业UI该有的样子。

4.4 扫描结果可视化：用不同颜色区分端口状态

JTable默认所有行一个色，但端口状态有四种：OPEN（绿色）、CLOSED（红色）、TIMEOUT（橙色）、FILTERED（灰色）。我们需要自定义TableCellRenderer。不重写整个渲染器，而是继承DefaultTableCellRenderer，只改getTableCellRendererComponent方法：

public class PortStatusRenderer extends DefaultTableCellRenderer { @Override public Component getTableCellRendererComponent(JTable table, Object value, boolean isSelected, boolean hasFocus, int row, int column) { super.getTableCellRendererComponent(table, value, isSelected, hasFocus, row, column); if (value instanceof PortStatus) { PortStatus status = (PortStatus) value; switch (status) { case OPEN: setBackground(Color.GREEN); setForeground(Color.WHITE); break; case CLOSED: setBackground(Color.RED); setForeground(Color.WHITE); break; case TIMEOUT: setBackground(new Color(255, 165, 0)); // 橙色 setForeground(Color.BLACK); break; case FILTERED: setBackground(Color.LIGHT_GRAY); setForeground(Color.BLACK); break; default: setBackground(table.getBackground()); setForeground(table.getForeground()); } } return this; } }

然后在ScannerPanel初始化resultTable后，设置渲染器：

resultTable.getColumnModel().getColumn(1).setCellRenderer(new PortStatusRenderer());

这样，表格第二列（状态列）就自动按状态上色。用户一眼扫过去，绿色块就是能连上的端口，红色块是明确拒绝，橙色块是网络不通——信息密度瞬间提升，这才是UI该干的事。

4.5 打包与分发：一个jar包，全平台通行

Maven打包后，target/port-scanner-ui-1.0-SNAPSHOT.jar就是最终产物。但直接双击，Windows可能用记事本打开，Mac可能报“已损坏”。解决方案：

• Windows：写一个launch.bat，内容就一行：java -jar port-scanner-ui-1.0-SNAPSHOT.jar。用户双击bat，自动调用系统JRE。
• Mac：写一个launch.command，首行加#!/bin/bash，第二行java -jar port-scanner-ui-1.0-SNAPSHOT.jar，然后终端执行chmod +x launch.command。
• Linux：同Mac，chmod +x launch.sh。

更进一步，可以用jpackage（JDK 14+）生成原生安装包：

jpackage --input target/ --name "PortScanner" --main-jar port-scanner-ui-1.0-SNAPSHOT.jar --main-class com.example.scanner.MainFrame

它会生成Windows的.msi、Mac的.dmg、Linux的.deb，图标、菜单项、卸载程序全配好。但对小工具来说，一个jar包+一个启动脚本，已经足够轻量。我给某公司IT部门做的版本，就是发一个zip包，里面scanner.jar和start.bat，他们拷到几十台测试机上，五秒搞定，没人问“怎么装Java”。

5. 常见问题与排查技巧实录

5.1 典型问题速查表

5.2 我踩过的三个深坑与独家避坑技巧

坑一：Socket未正确关闭，导致“Too many open files”
现象：连续扫描十几次后，程序报java.io.IOException: Too many open files，系统级错误。
原因：Socket.connect()抛异常时，socket对象可能已部分创建，但finally块里socket.close()没执行（比如socket变量是null，或close()本身抛异常）。
避坑技巧：永远用try-with-resources。修改scanPort方法：

public PortStatus scanPort(String ip, int port, int timeoutMs) { try (Socket socket = new Socket()) { // 自动close socket.connect(new InetSocketAddress(ip, port), timeoutMs); return PortStatus.OPEN; } catch (IOException e) { // 异常处理逻辑不变 } }

try-with-resources保证无论connect()成功与否，socket.close()都会被调用，彻底杜绝句柄泄漏。

坑二：JTable在SwingWorker.done()中更新崩溃
现象：扫描完成，done()里调用model.addRow()，偶尔抛java.lang.ArrayIndexOutOfBoundsException。
原因：JTable的DefaultTableModel不是线程安全的，done()虽在EDT中，但SwingWorker的publish()/process()机制可能引发竞态。
避坑技巧：用SwingUtilities.invokeLater()二次包裹UI更新。即使已在EDT，也加一层保险：

@Override protected void done() { try { List<PortScanResult> results = get(); SwingUtilities.invokeLater(() -> { updateResultTable(results); statusLabel.setText("扫描完成，共" + results.size() + "个端口"); }); } catch (Exception e) { e.printStackTrace(); } }

这行代码成本几乎为零，但