Vimium C 项目中自定义搜索引擎的URL编码处理技巧

在使用 Vimium C 浏览器扩展时，用户可以通过自定义搜索引擎功能快速访问常用网站。然而，当涉及到包含特殊字符（如冒号、斜杠等）的URL查询时，默认的URL编码行为可能会导致某些网站无法正常访问。

问题背景

以 Wayback Machine（网页存档服务）为例，用户创建了一个自定义搜索引擎别名"wa"，其搜索模板为：

wa: https://web.archive.org/web/*/$s Web Archive

当用户输入类似wa https://example.com/test的查询时，Vimium C 默认会对查询部分进行URL编码，生成类似https://web.archive.org/web/*/https%3A%2F%2Fexample.com%2Ftest的URL。这种编码后的URL格式不被Wayback Machine支持，导致访问失败。

解决方案

Vimium C 提供了两种不同的占位符来处理查询字符串：

1. $s - 会对查询字符串进行URL编码
2. $S - 保持查询字符串原样，不进行编码

对于需要保留原始URL格式的情况，应该使用$S占位符。因此，正确的自定义搜索引擎定义应为：

wa: https://web.archive.org/web/*/$S Web Archive

技术原理

URL编码（也称为百分号编码）是一种将特殊字符转换为%后跟两位十六进制数的机制。虽然这种编码对于大多数搜索引擎查询是必要的（可以防止URL解析错误），但对于某些特殊用途服务（如Wayback Machine）来说，它们需要接收原始的、未编码的URL作为查询参数。

Vimium C 通过提供两种不同的占位符来满足这两种需求：

• $s：安全模式，适用于大多数常规搜索引擎
• $S：原始模式，适用于需要保留特殊字符的场景

实际应用

这种区分在以下场景特别有用：

1. 网页存档服务（如Wayback Machine）
2. 某些API调试工具
3. 需要直接传递原始URL的网络服务
4. 开发者工具类网站

最佳实践

当创建自定义搜索引擎时，建议：

1. 首先尝试使用$s占位符
2. 如果遇到编码导致的问题，再尝试改用$S
3. 对于明确需要原始URL的服务，直接使用$S

通过理解Vimium C的这一特性，用户可以更灵活地配置各种自定义搜索引擎，满足不同的使用场景需求。