Swift中含本地语言的字符串转URL：解决nil及保留原字符需求

我懂你遇到的困扰——直接用带非ASCII本地语言字符的字符串创建URL会返回nil，用appendingPathComponent又会得到编码后的URL，但你希望能保留原字符的形式来显示或处理。咱们一步步拆解解决：

为什么直接初始化会失败？ #

根据URL的RFC标准，路径和查询参数里的非ASCII字符必须经过百分号编码才能被系统正确解析。当你调用URL(string: "www.mydomain.com/key=अक्षय")时，因为字符串包含未编码的印地语字符，系统无法识别为合法URL，所以返回nil。

正确的URL构造方式（兼顾有效性和显示需求） #

1. 用URLComponents规范构造URL（推荐） #

如果key=अक्षय是查询参数（而非路径的一部分），URLComponents是最稳妥的方案，它会自动处理编码，同时也能轻松还原原字符：

// 初始化基础URL组件
var components = URLComponents(string: "https://www.mydomain.com")!
// 创建查询项，直接传入原本地语言字符
let queryItem = URLQueryItem(name: "key", value: "अक्षय")
components.queryItems = [queryItem]

// 生成符合标准的编码URL（用于实际网络请求）
guard let encodedURL = components.url else {
    fatalError("Failed to create valid URL")
}

// 如果需要显示原字符的URL字符串，解码即可
if let decodedURLString = encodedURL.absoluteString.removingPercentEncoding {
    print(decodedURLString) // 输出: https://www.mydomain.com?key=अक्षय
}

2. 若需将key=अक्षय作为路径组件 #

如果你确实要把这段内容作为路径的一部分，可以先手动编码原字符串再构造URL，或者利用appendingPathComponent自动编码后解码显示：

// 方式1：手动编码路径组件
let baseURL = URL(string: "https://www.mydomain.com")!
let pathComponent = "key=अक्षय"
// 对路径组件进行utf8编码
if let encodedPath = pathComponent.addingPercentEncoding(withAllowedCharacters: .urlPathAllowed) {
    let url = baseURL.appendingPathComponent(encodedPath)
    // 解码还原原字符用于显示
    if let decodedPath = url.path.removingPercentEncoding {
        print("https://www.mydomain.com\(decodedPath)") // 输出: https://www.mydomain.com/key=अक्षय
    }
}

// 方式2：利用appendingPathComponent自动编码后解码
let url = URL(string: "https://www.mydomain.com")?.appendingPathComponent("key=अक्षय")
if let urlString = url?.absoluteString.removingPercentEncoding {
    print(urlString) // 输出: https://www.mydomain.com/key=अक्षय
}

关键注意事项 #

• 网络请求必须用编码后的URL：解码后的字符串仅适合用于UI显示，实际发送请求时一定要用编码后的URL实例，否则会导致请求失败。
• 优先用URLComponents处理查询参数：它能帮你规避很多编码错误，尤其是存在多个查询参数时，管理起来更清晰高效。

内容的提问来源于stack exchange，提问作者Akshay Phulare