根本原因是 VSCode 终端默认无权限发送原始 UDP 包，且 wakeonlan 依赖外部工具或未全局安装；可行解法是用 Node.js 的 dgram 模块手动构造 102 字节 Magic Packet（6 字节 0xFF + 16 次 MAC 地址），发往局域网广播地址端口 9，并确保 MAC 格式为 12 位小写十六进制、目标 IP 为正确广播地址。
为什么 wakeonlan 命令在 VSCode 终端里执行失败？
多数人卡在这一步：直接在 VSCode 集成终端里运行 wakeonlan，提示 command not found 或 Permission denied。根本原因不是 VSCode 本身限制，而是 Node 进程默认没权限发原始 UDP 包（尤其 macOS/Linux），且 wakeonlan 命令依赖系统级工具（如 netcat、python）或未全局安装。
真正可行的路径是：用 Node.js 自己构造 Magic Packet，绕过外部命令依赖，直接调用 udp4 socket 发送。VSCode 只是编辑+运行环境，关键在 Node 侧实现是否合规。
- Windows 下需确保网卡启用“允许此设备唤醒计算机”且 BIOS 中开启 Wake-on-LAN
- macOS 默认禁用 raw socket，必须用
sudo启动 Node 进程（或改用sudo setcap 'cap_net_raw+ep' /usr/bin/node，仅限 Linux） - VSCode 的终端若以普通用户启动，
sudo node app.js会因 TTY 权限问题卡住，建议改用外部终端运行
如何用 require('dgram') 手动构造 Magic Packet？
Node 内置 dgram 模块足够完成任务，无需额外包。Magic Packet 格式固定：6 字节 0xFF + 16 次重复的 6 字节 MAC 地址（共 102 字节）。重点不是“怎么拼”，而是“怎么发得准”：
- MAC 地址必须为十六进制字符串，不含
:或-，例如'a81e84c7b5f2'（12 位小写） - 目标 IP 必须是局域网广播地址（如
'192.168.1.255'），不能填目标机器的单播 IP - UDP 端口固定用
9（虽然部分设备也监听7，但9是标准） - 务必调用
socket.bind()显式绑定本地端口，否则某些系统（尤其是 Windows）会发不出包
const dgram = require('dgram');
const mac = Buffer.from('a81e84c7b5f2', 'hex');
const packet = Buffer.alloc(102, 0xff);
for (let i = 0; i < 16; i++) {
mac.copy(packet, 6 + i * 6);
}
const socket = dgram.createSocket('udp4');
socket.bind(() => {
socket.send(packet, 9, '192.168.1.255', () => socket.close());
});
VSCode 调试时遇到 EACCES 或 EINVAL 怎么办？
错误信息直指底层权限或参数异常：EACCES 是 socket 绑定被拒（缺 root 权限或端口被占），EINVAL 多因 MAC 地址长度不对或目标地址非广播地址。
- 检查当前用户是否在
netdev组（Linux），或是否以管理员身份运行 VSCode（Windows） - 确认目标 IP 确实是本机所在子网的广播地址——用
ipconfig（Win）或ifconfig（macOS/Linux）核对网关和掩码，再算出广播地址 - Node 版本低于 14.18 时，
dgram在某些系统上对广播支持不稳定，建议升到16.14+或18.12+ - 如果发包后目标无反应，先用 Wireshark 抓包验证是否真发出——很多“发送成功”只是 Node 认为发出了，实际被防火墙/网卡丢弃
能否在 VSCode 里一键触发而不手动敲命令？
可以，但别依赖 VSCode 的“运行任务”直接跑脚本。更可靠的方式是配置 tasks.json 调用带 sudo 的 shell 命令，或用 VSCode 插件 Code Runner 配置自定义执行命令：
- 在
.vscode/tasks.json中写："command": "sudo", "args": ["node", "${file}"]并确保当前用户免密 sudonode（visudo加youruser ALL=(ALL) NOPASSWD: /usr/bin/node） - 避免用
process.exec()调wakeonlan，它无法继承终端的 sudo 环境，且跨平台兼容差 - 真正省事的做法：把上面的
dgram逻辑封装成 CLI 工具（比如npm link全局安装），然后在 VSCode 终端里直接敲send-wol a81e84c7b5f2
最易忽略的是网卡混杂模式与防火墙——即使代码全对，物理层拦截了，包也到不了目标机器。发包前先 ping 通广播地址，比什么都管用。
