独立站素材路径带空格，生成安全相对URL清单要处理的不是商品效果，而是一类可以由程序明确判断的输入问题。输入使用POSIX风格相对路径，每一段分别quote编码。拒绝绝对路径、上跳、空段、反斜线与冒号，防止把本地盘符或目录逃逸当作素材URL。
独立站素材路径带空格，生成安全相对URL清单要处理的不是商品效果，而是一类可以由程序明确判断的输入问题。输入使用POSIX风格相对路径，每一段分别quote编码。拒绝绝对路径、上跳、空段、反斜线与冒号，防止把本地盘符或目录逃逸当作素材URL。
输入契约与实现
输入使用POSIX风格相对路径，每一段分别quote编码。拒绝绝对路径、上跳、空段、反斜线与冒号，防止把本地盘符或目录逃逸当作素材URL。
代码把相对素材URL编码限定成小范围任务，刻意不增加网络请求、文件覆盖和发布动作。
运行结果与排错
中文与空格被编码，目录斜杠保留；上跳、绝对地址、Windows盘符与空路径段四类输入被拒绝。
编码不验证文件存在，也不执行上传；已编码输入会再次编码百分号，因此契约要求提供原始路径而非混合编码串。如果要扩大范围，先添加对应失败夹具，再修改实现。
成功分支同样要验证结果含义。
放在图片制作链路的哪里
这个工具适合放在URL工具相关的本地资料整理环节，和图像制作保持解耦。
实际交接至少保留输入版本、代码版本和完整报告。
本例的覆盖范围是：中文与空格被编码，目录斜杠保留；上跳、绝对地址、Windows盘符与空路径段四类输入被拒绝。未覆盖的边界是：编码不验证文件存在，也不执行上传；已编码输入会再次编码百分号，因此契约要求提供原始路径而非混合编码串。
from urllib.parse import quote
import json
def relative_url(path):
if not isinstance(path, str) or not path:
raise ValueError('empty_path')
if path.startswith('/') or '\\\\' in path or ':' in path:
raise ValueError('absolute_or_non_posix')
parts = path.split('/')
if any(p in ('', '.', '..') for p in parts):
raise ValueError('unsafe_segment')
return '/'.join(quote(p, safe='') for p in parts)
good = relative_url('images/红色 杯子.png')
assert good == 'images/%E7%BA%A2%E8%89%B2%20%E6%9D%AF%E5%AD%90.png'
errors = []
for bad in ('../a.png', '/a.png', 'C:/a.png', 'images//a.png'):
try:
relative_url(bad)
except ValueError as exc:
errors.append(str(exc))
else:
raise AssertionError('expected rejection')
assert len(errors) == 4
print(json.dumps({'url': good, 'errors': errors}))
编辑复核与下一组测试
相对URL清单要同时保留原始路径与编码结果，便于判断问题来自路径结构还是字符表达。本文按POSIX风格路径逐段quote，中文与空格被编码，而目录斜杠继续表示层级；如果把整条路径一次编码并把斜杠也当作文件名字符，就会改变素材的目录关系。读到上跳、绝对地址、Windows盘符或空路径段被拒绝时，应先检查输入到底是素材根目录内的相对路径，还是从本地文件管理器直接复制来的完整位置。上跳不应通过删掉两个点来修复，因为那会改变目标含义；盘符与反斜线也不宜简单替换后继续使用，应先确定文件在发布目录下的真实相对位置。空路径段提示目录分隔结构不符合约定，整理人员需要核对是否多写了斜杠，而不是期待编码自动规范化。冒号被拒绝同样说明本例不是处理任意完整网址的工具，已有站点地址应交给另一个明确的URL流程，而非混入素材相对路径。已有编码串是另一个容易在交接中产生的错误：本文要求原始路径，如果把带百分号的编码结果再次送入，百分号还会编码，得到的地址就不再是第一次输出。应在清单列名中区分原始素材路径和相对URL，避免下一位编辑把结果列当成输入列重跑。下一组测试可用含中文、空格的两级目录与同名根目录文件作对照，确认目录斜杠被保留；再分别给出上跳、开头斜杠、Windows盘符和连续斜杠，独立覆盖四类拒绝路径。还可加入文件名含百分号、问号或井号的原始路径，核对这些字符如何作为文件名内容被编码，不要将它们预先解释成查询参数或页面片段。对于已经编码的输入，应作为契约违例的说明样本展示再次编码现象，不宣称当前实现会自动识别或还原它。最合适的交接点是素材目录已整理、页面引用尚未写入模板时，目录负责人提供原始相对位置，页面编辑使用生成的URL。报告没有检查文件存在，也没有执行上传；编码成功后仍需对照发布目录或上传清单确认素材可访问。这样能把字符编码、目录定位和实际发布三个问题分开，避免看到一串合法编码就误认为链接已经可用。