ABP v10.0.3自定义模板拉取与变量替换问题求助

1. 拉取版本控制系统中的模板文件 #

直接从版本控制系统拉取完整的模板文件夹到本地任意干净目录，不要提前重命名为module-v.10.0.3.zip，手动重命名会破坏模板元数据关联。

2. 修复模板名称替换失效问题 #

模板创建后仍显示MyCompany.MyProject，是因为模板的变量替换规则未正确配置，需修改模板根目录下的.template.config/template.json：

• 确认name字段为占位符格式："name": "MyCompany.MyProject"
• 检查symbols节点，确保包含项目、公司名称的替换规则，示例配置：

  "symbols": {
    "CompanyName": {
      "type": "parameter",
      "defaultValue": "MyCompany",
      "replaces": "MyCompany",
      "isRequired": true
    },
    "ProjectName": {
      "type": "parameter",
      "defaultValue": "MyProject",
      "replaces": "MyProject",
      "isRequired": true
    }
  }
  

• 同步检查模板内所有文件的内容、文件名，确保需要替换的位置都使用了MyCompany.MyProject这类占位符。

3. 本地安装自定义模板 #

打开终端进入拉取后的模板根目录，执行ABP CLI安装命令：

abp add template --name MyCustomModule --version 10.0.3 --path .

• --name：自定义模板名称（后续创建项目时会用到）
• --version：必须与ABP版本（10.0.3）保持一致
• --path：指定当前模板所在目录

4. 使用自定义模板创建项目 #

执行创建命令时指定你的自定义模板名称：

abp new YourProjectName --template MyCustomModule --version 10.0.3

此时所有MyCompany.MyProject占位符会自动替换为你输入的项目名称及参数。

额外注意事项 #

• 若拉取的是旧版本模板，需确认.template.config目录下的配置文件结构与ABP v10.0.3匹配，部分新版本模板会新增abp-template.json配置文件，需同步调整。

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