在 macos xcode 项目中配置多语言本地化需创建 localizable.strings 文件并为各语言生成对应版本，通过 nslocalizedstring 调用；关键步骤包括新建 strings 文件、启用本地化、添加语言、规范编写键值对、正确编码调用及 scheme 中设置应用语言验证效果。
在 macos 的 xcode 项目中配置多语言本地化字符串文件，核心是创建标准的 localizable.strings 文件，并为每种语言生成对应版本，再通过 nslocalizedstring 在代码中调用。整个过程不依赖 storyboard（命令行或 appkit 应用都适用），关键在于资源组织和编译配置。
创建 Localizable.strings 并启用本地化
先在项目中新建一个 Strings File：
- 右键项目导航器 → New File… → 选择 macOS > Resource > Strings File
- 命名为
Localizable.strings（这是系统默认查找的文件名） - 确保该文件已加入当前 Target（在 File Inspector 的 Target Membership 中勾选）
- 选中该文件，在右侧 File Inspector 中点击 Localize… 按钮
- 在弹窗中选择基础语言（如 English），点击 Localize
- 之后再点 + 添加其他语言，例如 Chinese (Simplified) 或 Japanese
Xcode 会自动为每种语言生成独立的 Localizable.strings 文件，并放入对应语言目录（如 en.lproj/、zh-Hans.lproj/）。
按规范填写各语言的字符串内容
每个 .strings 文件使用标准键值对格式，注意语法细节：
- 必须用双引号包裹 key 和 value，等号两侧有空格，结尾带分号
- key 保持一致，value 按语言翻译，例如：
en.lproj/Localizable.strings：
"welcome_title" = "Welcome to MyApp";
"save_button" = "Save";
zh-Hans.lproj/Localizable.strings：
"welcome_title" = "欢迎使用 MyApp";
"save_button" = "保存";
注：中文引号、全角标点、换行符或未闭合引号会导致编译警告甚至加载失败。
在代码中正确引用本地化字符串
Swift 和 Objective-C 都使用 NSLocalizedString 宏，系统自动根据用户系统语言匹配对应 .strings 文件：
- Swift 示例：
let title = NSLocalizedString("welcome_title", comment: "App main window title") - Objective-C 示例：
NSString *title = NSLocalizedString(@"welcome_title", @"App main window title"); -
comment参数虽非必需，但建议填写上下文说明，方便后期翻译协作 - 若需指定特定语言表（非常规场景），可用
NSLocalizedStringFromTable
验证与调试本地化效果
运行前需确认语言环境是否生效：
- 在 Xcode 中选择 Product > Scheme > Edit Scheme…
- 左侧选 Run → 右侧选 Options 标签页
- 展开 Application Language 下拉菜单，手动选择目标语言（如 Chinese (Simplified)）
- 运行应用，检查界面文本是否切换成功
- 也可在终端临时测试：
defaults write NSGlobalDomain AppleLanguages '("zh-Hans")'，重启应用生效（需重置才能恢复）
