Swift 4调用自定义URL返回nil，如何解决字符集问题？

我太懂你这种崩溃感了——明明自定义的URL字符串看着没问题，用URL(string:)初始化却总是返回nil，找的旧Swift代码还全失效了。其实核心问题就是URL中包含未编码的特殊字符（比如空格、中文、特殊符号），Swift 4里有几个更可靠的新方法来解决这个问题，下面给你详细说：

方案1：对路径部分单独编码 #

如果你的URL是由基础域名加带特殊字符的路径组成，别直接把整个字符串丢给URL(string:)，应该把路径部分单独编码后再拼接：

let baseDomain = "https://mycustomsite.com/"
let rawPath = "用户中心/我的收藏 2024"

// 对路径部分进行编码，保留URL路径允许的合法字符，自动转义特殊字符
guard let encodedPath = rawPath.addingPercentEncoding(withAllowedCharacters: .urlPathAllowed) else {
    print("路径编码失败")
    return
}

// 拼接后再初始化URL
if let validURL = URL(string: baseDomain + encodedPath) {
    print("成功创建URL：\(validURL)")
} else {
    print("URL初始化失败")
}

这里的.urlPathAllowed字符集已经帮你预设好了路径里允许的字符（比如/、_、-），其他特殊字符会被自动转成百分号编码，不会破坏URL结构。

方案2：用URLComponents构建URL（最推荐） #

如果你的URL包含查询参数或者复杂结构，URLComponents是最稳妥的选择——它会自动帮你处理所有部分的编码，完全不用手动操心：

var components = URLComponents()
components.scheme = "https"
components.host = "mycustomsite.com"
components.path = "/用户中心/我的收藏"
// 添加查询参数，参数值带特殊字符也没关系
components.queryItems = [
    URLQueryItem(name: "category", value: "科技&数码"),
    URLQueryItem(name: "page", value: "3")
]

if let validURL = components.url {
    print("成功创建URL：\(validURL)")
} else {
    print("URL组件构建失败")
}

这种方式把URL的各个部分（协议、域名、路径、参数）拆分开来处理，URLComponents会按照标准自动编码每一部分，从根源上避免了手动拼接的编码错误。

方案3：单独编码查询参数 #

如果只是查询参数里有特殊字符，也可以单独编码参数值后再拼接：

let baseURLString = "https://mycustomsite.com/api/getData"
let rawParamValue = "包含&=!的参数值"

guard let encodedParam = rawParamValue.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) else {
    print("参数编码失败")
    return
}

let fullURLString = "\(baseURLString)?param=\(encodedParam)"
if let validURL = URL(string: fullURLString) {
    print("成功创建URL：\(validURL)")
}

这里用.urlQueryAllowed字符集专门处理查询参数的编码，确保参数里的特殊字符被正确转义。

为什么旧代码不行？ #

之前Swift版本里的stringByAddingPercentEncodingWithAllowedCharacters方法在Swift 3之后就被废弃了，Swift 4及以后改用addingPercentEncoding(withAllowedCharacters:)这个新API，所以旧代码自然跑不起来啦。

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