Xcode开发无关联.xcodeproj的本地库时IDETemplateMacros.plist不生效如何解决

生效原理说明 #

Xcode 全局路径下的IDETemplateMacros.plist默认仅对关联了.xcodeproj/.xcworkspace的项目上下文生效。你打开无项目配置的本地库文件夹时，Xcode会切换到极简文件夹项目模式，默认不会读取全局UserData目录下的宏配置，因此只会生成空的注释行。

可行解决方案 #

方案1：添加目录级宏配置（推荐，不影响全局配置）

• 首先执行终端命令开启Xcode对文件夹项目的宏读取权限：

defaults write com.apple.dt.Xcode IDETemplateMacrosApplyToFolderProjects -bool true

• 完全退出Xcode后，在你的本地库根目录创建隐藏文件夹.xcode，将你现有的IDETemplateMacros.plist文件放入该文件夹内，最终路径为本地库根目录/.xcode/IDETemplateMacros.plist
• 重新打开本地库文件夹，新建文件即可生效

方案2：修改Xcode内置模板（全局所有无项目场景生效）

• 打开Xcode内置模板路径：/Applications/Xcode.app/Contents/Developer/Library/Xcode/Templates/File Templates/Source
• 找到你常用的文件类型对应的模板包，比如Swift文件对应Swift File.xctemplate，右键选择「显示包内容」
• 打开包内的___FILEBASENAME___.swift（不同文件类型后缀不同），直接修改顶部的文件头内容为你需要的版权声明即可
• 注意：Xcode版本更新后会覆盖内置模板，更新后需要重新配置

方案3：使用自定义代码片段替代（无依赖，全场景可用）

• 任意打开一个Xcode编辑窗口，写好你需要的文件头内容
• 选中写好的文件头，长按拖动到右侧的代码片段库面板
• 双击保存的代码片段，设置触发词比如header，后续新建文件后输入触发词即可自动补全自定义文件头

验证方式 #

所有配置修改完成后，需要完全退出Xcode再重新打开本地库目录，新建文件即可验证是否生效。

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