嘿，我之前自定义T4模板的时候也碰到过这种两头卡的糟心问题，给你梳理下根因和解决思路：

先搞懂矛盾的本质 #

你现在卡在T4模板的两个核心阶段上：

• 脚手架执行阶段：T4引擎会先编译并运行你的模板代码，生成对应的Controller文件
• 项目编译阶段：Visual Studio会编译生成好的Controller代码，检查语法正确性

你的两种写法刚好踩中了这两个阶段的语法冲突：

• 用length:1时，T4引擎能顺利跑通模板（脚手架执行成功），但生成的Controller代码里会出现length:1这种不符合C#语法的内容，直接导致项目编译报错
• 用length-1时，生成的代码语法是对的（项目能编译），但T4引擎在执行模板时，编译模板本身的代码就失败了（提示“Compiling tr...”就是模板代码编译出错的典型表现）

一步步排查修复 #

1. 先分清T4模板里的代码区域

T4模板里有三种不同的代码区域，千万别混了：

• 纯文本区域：直接输出到生成文件里的内容（就是你最终想在Controller里看到的代码）
• 模板执行代码块：用<# ... #>包裹的代码，这部分是给T4引擎运行的，不会直接输出到生成文件
• 表达式输出块：用<#= ... #>包裹的代码，会把模板变量的计算结果输出到生成文件里

举个例子，如果你想生成var trimmed = name.Substring(0, 5);（这里的5是length-1的结果），正确的写法应该是：

<#
// 这部分是模板执行代码：先计算好要输出的数值
int length = Model.EntityName.Length; // 假设length是模板里拿到的原始长度
int adjustedLength = length - 1; // 这里用减号是合法的C#语法，T4引擎能正常编译
#>
// 这部分是生成到Controller的代码，用表达式输出计算好的值
var trimmed = name.Substring(0, <#= adjustedLength #>);

2. 排查模板代码的语法错误

当你用length-1时脚手架执行失败，大概率是模板本身的代码有问题：

• 先确认length变量在模板的<# ... #>块里已经正确声明和赋值了（比如有没有拼写错，或者变量还没初始化就用了）
• 检查表达式输出块有没有写对：比如是不是漏了<#=或者#>，导致T4引擎把length-1当成模板执行代码的一部分，而不是要输出到生成文件的内容
• 尽量把复杂的计算逻辑放到模板执行代码块里，别直接在表达式里写运算，这样能减少语法冲突的概率

3. 调试T4模板找问题

如果还是摸不着头脑，可以开T4的调试模式：

• 在模板文件的最顶部加上<#@ debug="true" #>指令
• 再运行脚手架的时候，会自动触发调试器，你可以逐行看模板代码的执行情况，看看length的值到底是什么，以及哪一行代码导致了编译报错

给你个现成的修复示例 #

假设你原来的错误代码是这样的：

// 错误写法：混淆了模板语法和生成代码语法
var trimmed = name.Substring(0, <# length:1 #>);

改成下面这样就没问题了：

<#
// 模板里先计算好调整后的长度
int originalLength = Model.EntityName.Length;
int adjustedLength = originalLength - 1;
#>
// 生成合法的C#代码
var trimmed = name.Substring(0, <#= adjustedLength #>);

这样一来：

• 脚手架执行时，T4引擎能正常编译运行模板代码
• 生成的Controller代码里会是合法的C#语法，项目编译也能顺利通过

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