升级Xcode 16后自定义xctemplate模板不显示问题咨询

核心变更：模板路径优先级调整 #

Xcode 16 对自定义模板的扫描路径做了调整，全局路径 /Library/Developer/Xcode/Templates/File Templates 不再被默认优先加载，官方现在推荐使用用户级路径：

~/Library/Developer/Xcode/Templates/File Templates

你可以直接将原路径下的模板文件夹移动到这个用户目录下的对应位置，再重启Xcode尝试。

其他排查点 #

• 目录结构必须合规：每个自定义模板必须放在后缀为 .xctemplate 的子文件夹中，不能直接将模板文件放在File Templates根目录下。正确结构示例：

  File Templates/MyCustomTemplates/VMBaseTemplate.xctemplate
  

• 检查TemplateInfo.plist配置：
  • 确认Kind字段值正确（文件模板对应Xcode.IDEKit.TextSubstitutionFileTemplateKind）
  • 确保Platforms字段包含你当前开发的平台（如iOS、macOS），未指定平台的模板可能不会在对应界面显示
  • 验证plist文件无语法错误，可通过Xcode打开plist文件检查格式
• 清除Xcode缓存：
  1. 彻底退出Xcode（包括后台进程）
  2. 删除缓存目录：~/Library/Caches/com.apple.dt.Xcode
  3. 重新启动Xcode
• 修复权限问题：
  如果模板目录权限不足，Xcode无法读取，可在终端执行：

  sudo chmod -R 755 ~/Library/Developer/Xcode/Templates
  

内容的提问来源于stack exchange，提问作者Mohamed Amine Souiden