必须确保GRBL固件正确烧录、串口通信正常、LaserGRBL识别设备且SVG被准确解析为路径；否则将出现“连接成功但无反应”或“预览为空”。
要在Windows系统上连接激光雕刻机并输出矢量图进行雕刻，必须确保GRBL控制器已正确烧录固件、串口通信正常、LaserGRBL能识别设备且SVG文件被准确解析为可执行路径。跳过任一环节都会导致“连接成功但无反应”或“图像导入后预览为空”。
确认硬件连接与端口识别
用USB线将激光雕刻机接入Windows电脑，观察设备管理器中是否出现带“CH340”“CP210x”或“FTDI”字样的COM端口；若未出现，需手动安装对应USB转串口驱动（如CH340驱动不装，LaserGRBL根本看不到端口）。
右键“此电脑”→“管理”→“设备管理器”→展开“端口（COM和LPT）”，记下新出现的COM编号（例如COM7），【该编号后续在LaserGRBL中必须完全一致，输错一位就无法握手】。
关闭所有占用串口的软件（尤其是Arduino IDE、串口调试助手），否则LaserGRBL会提示“端口被占用”。
启动LaserGRBL并建立稳定连接
打开LaserGRBL软件，点击工具栏左上角闪电图标 → 在弹出窗口中选择刚才记下的COM端口（如COM7）→ 设置波特率为115200（GRBL默认值）→ 点击“Connect”。
连接成功时，状态面板会显示“Grbl 1.1f”或类似版本号，且坐标栏实时刷新X/Y位置；若显示“Not Connected”或反复断连，大概率是USB线接触不良或雕刻机未上电——【务必先开雕刻机电源，再点连接】。
首次连接后，建议点击“Actions”→“Get Grbl Settings”读取当前参数，确认=1（启用激光模式），否则SVG导入后可能不出光。
用于设计、审查、生成或重构使用Effector、effector-react、Farfetched、AtomicRouter、@effector/next等库的React应用。
导入SVG并生成有效雕刻路径
方法一：直接拖入法
将准备好的SVG文件（须为纯矢量路径，不含位图嵌入）直接拖进LaserGRBL预览窗口空白处，松手即自动加载。
方法二：菜单导入法
点击“File”→“Open”→选择SVG文件→在弹出的“Vector Import Options”对话框中：勾选“Convert to paths”（强制转为路径）、取消勾选“Import as raster”（避免误作图片处理）、设置“Scale factor”为1.0（防止缩放失真）。
导入后预览窗口应清晰显示线条轮廓；若只看到一个空矩形框或报错“Invalid SVG”，说明该SVG含CSS样式、文本未转曲、或使用了不支持的滤镜效果——请用Inkscape打开→选中文字→“Path”→“Object to Path”，再另存为纯净SVG 1.1格式。
设置功率与运动参数并发送雕刻指令
第一步：在参数设置区顶部下拉框选择材料预设（如“Wood_3mm”），或手动输入：
• $30（激光最大功率）设为255（对应100%）
• $31（最小功率）设为0（保证关断彻底）
• $110（X轴步进/mm）与$111（Y轴步进/mm）必须与你的机械结构匹配（常见为80或160）
第二步：点击预览窗口右键→“Set Origin Here”将原点定在雕刻起点（通常为左下角），再点击“Move To Origin”让激光头物理归位。
第三步：检查状态面板右下角是否显示“Ready”，确认无报警（如“Hard limit”“Alarm”）；确认激光头下方已放置材料并聚焦完毕。
最后点击播放按钮（▶️），LaserGRBL开始逐段发送G代码，雕刻机同步执行矢量路径——此时预览窗口中的红色轨迹线会随实际运动实时高亮推进。
