操作与方法说明
点线偏距、垂足和线段最近点怎么区分
“这个点离线多远”需要先说明线是否允许延伸。基线方向决定左右正负，端点范围决定最近距离。本页将这两件事分别展示，便于核对与交接。
先定义有方向的基线
输入 A 的东、北坐标，再输入 B 的东、北坐标。A 是起点，B 是终点，工具按 A → B 定义前进方向。待算点 P 与基线必须属于同一平面坐标框架，使用同一种水平单位。若基线来自图纸、待算点来自仪器导出，不能因为都标注“米”就默认坐标一致，应核实项目坐标、轴向及必要的转换记录。
源文件使用 X、Y 标题时，请根据文件说明确认哪个是东、哪个是北。本工具不把 X/Y 自动当作某一种顺序。建议用位置关系明确的已知点先试算，再处理批量数据；东、北对调可能得到看起来合理的数值，却改变方向与左右侧。
沿线距离从哪里开始算
从 P 向无限延长的 AB 直线作垂线，其垂足记为 F。沿线距离就是从 A 沿 A → B 方向量到 F 的有符号水平距离。A 处为零，A 之前为负，超过 B 时会大于基线长度。它描述垂足的位置，不是 P 到 A 的斜向距离。
本工具没有道路曲线、缓和曲线、断链或起始里程设置，因此输出不直接等同于线路桩号。如果你的任务确实用一条直线且从 A 的零点起算，可以据此解释沿线距离；需要叠加项目起始里程时，应另行保留里程定义与依据。
偏距为什么有正负
站在 A 看向 B，本工具约定右侧偏距为正，左侧为负，恰好在直线上为零。数值绝对值就是点到无限直线的垂直距离。报告同时给出“右侧／左侧／基线上”文字，避免交接时只看一个符号而误解。
例如 A 为 E 0、N 0，B 为 E 0、N 100，基线朝北。P 为 E 10、N 20 时，垂足是 E 0、N 20，沿线距离为 20，偏距为右侧 +10。若平面单位为米，这两个距离也都为米；如果选择英尺，数值本身不会自动换算。
垂足超出端点，应该看哪个距离
无限直线模式允许 AB 向两端延伸，使用 P 到 F 的垂距作为选用距离。有限线段模式只考虑 A、B 之间的部分：垂足在范围内时，最近点 C 与 F 重合；垂足在 A 之前或 B 之后时，最近点 C 分别取 A 或 B。
把上面的 P 改为 E 3、N 104，垂足变成 E 0、N 104，已超过 B。点到无限直线的距离为 3，但点到有限线段最近的是终点 B，距离为 5。工具保留这两个值，不会把延长线垂足偷偷夹回端点，再把新的距离叫作垂距。
即使选择有限线段模式，有符号偏距仍相对于无限直线；它不变成“带符号的端点距离”。例如 P 在线的延长线上，偏距可为零，而线段距离仍大于零。因此需要结合“垂足位置”列判断，不应把偏距为零理解成点一定落在 AB 线段上。
交换起终点会发生什么
交换 A 与 B 后，同一条几何直线仍在原位置，但前进方向相反，所以右侧变左侧，偏距符号随之改变。沿线距离改从新的起点量取。垂足坐标、点到直线的绝对距离和点到线段的距离则保持一致。
朝北基线中沿线 20、右偏 10 的示例，反向后变为沿线 80、左偏 10。原来位于 B 之后的垂足，可能成为新起点之前的垂足。与其他软件对比时，要一起核对端点顺序和左右正负规则；有的软件采用左正右负，符号不同本身不一定说明坐标算错。
从坐标文件批量计算
切换为点文件模式后，可读取 UTF-8 的 CSV 或 TXT，先预览源列并确认东、北坐标映射及平面单位，再填写基线坐标与坐标依据。文件中的全部记录都作为待算点处理；基线端点若也在文件里，不会自动删除，通常会产生零距离结果。 此处也可读取XLSX工作簿，须主动选择工作表；公式、日期及错误单元格请先核对并转为普通值。
重复点号仍按不同源记录保留，可通过源行号区分。带源错误的记录不会参与有效计算，也不会从报告中消失，而是保持待处理并给出原因。先修复源文件，再重新计算相应记录。附带高程和描述可以保留在来源数据中，但本工具只做水平二维计算，不插算垂足高程。
基线坐标单独输入，适合基线不在待算点文件中的情况。请使用文件对应的同一单位填写，单位下拉框只是说明输入含义，不负责换算。坐标依据建议写清测区坐标框架、图纸版本及用途，便于下一位复核者理解结果。
怎样检查结果与导出报告
表格每页显示二十五条，点击源行号可看当前点详情。A、B 为基线端点，P 为待算点，F 为无限直线垂足，C 为有限线段最近点。示意图北向上、东向右，以 A 为相对原点；重合标记可能叠在一起，应以详情中的坐标和距离为准。
距离在表格中显示六位小数，极大、极小值使用科学计数法；报告保留计算数值精度。推算垂足坐标以舍入后的小数字符串保存，位数多并不意味着外业精度高。工具先按原始十进制文本处理坐标差与几何乘积，减少大坐标下小偏距被相消的问题；超出数值范围时会明确标为无法计算。
CSV 包含原坐标、源行、左右侧、垂足位置、垂足坐标、线段最近点、两类距离、选用模式、基线坐标、单位和依据。JSON 另保留完整来源结构与设置。计算得到的正负距离保持数值形式，可能触发表格公式的原始文本会保护处理。报告用于计算复核，不是新的测量点文件。
使用范围与本地处理
输入必须为平面坐标，不支持经纬度直接计算、地面比例改正、坐标转换、三维点线距离或道路定线反算。工具也不根据某个偏距自动作出工程合格判断；验收标准和容差要根据项目规范另行评价。
文件在浏览器中处理，输入上限 10 MiB、100,000 条记录，CSV 报告上限同为 10 MiB。报告过大时可以拆分来源或保存 JSON。修改输入与设置会清除旧结果，防止下载到与当前条件不一致的报告；取消运行保留输入，清空本次数据会移除当前会话数据。