Swift中Realm与Permission库类名冲突，如何正确引用目标模块类？

Hey there! I’ve dealt with this exact class name collision issue in CocoaPods before—super frustrating when the compiler can’t tell which type you mean. Let’s walk through the most reliable fixes to get you referencing the correct Permission class from your desired module.

1. Rename the Imported Module (Most Reliable Fix) #

This approach eliminates the ambiguity entirely by giving the Permission pod a unique alias in your code. Instead of the standard import Permission, use this in any file where you need the Permission module’s class:

import Permission as AppPermission

Now you can clearly reference the class without conflicts using:

let myPermission = AppPermission.Permission()

This keeps your code readable and avoids any confusion with Realm’s Permission type.

2. Verify the Module Name and Use Fully Qualified Syntax #

If you prefer not to alias the module, first double-check the actual module name of your Permission pod—sometimes it might not match the pod’s name exactly:

• Navigate to your project’s Pods folder, find the Permission library directory, and check its .modulemap file or Info.plist (look for CFBundleIdentifier, which often matches the module name).
• Alternatively, check the Permission pod’s podspec file for a module_name field (if defined).

Once you confirm the correct module name, try using the fully qualified type. If the module name is indeed Permission, and Permission.Permission still throws an error, try these troubleshooting steps:

• Clean your project’s build folder: Go to Xcode → Product → Clean Build Folder (hold the Option key to see this option if it’s hidden).
• Reinstall your pods: Run pod deintegrate && pod install in your terminal.
• Restart Xcode to clear any cached module data.

After these steps, Permission.Permission should correctly resolve to the class from your Permission module.

3. Limit Realm’s Import Scope #

If you don’t need Realm’s Permission class in the file where the conflict occurs, adjust how you import Realm. Instead of importing the full Realm module:

import Realm

Use the Swift-specific import (if you’re using RealmSwift):

import RealmSwift

This imports only the Swift-friendly types from Realm and often excludes the lower-level Permission class that’s causing the collision.

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