PowerShell调用ToString()格式化时字符串内0被自动替换的规则及禁用方法

你观察到的0被替换的行为，和PowerShell本身、ForEach-Object cmdlet没有直接关系，也不是PowerShell默认把字符串里的0识别为计数器占位符。该行为是**.NET数值类型ToString(format)方法重载的内置自定义数字格式化规则**，所有.NET语言调用该方法时都会出现一致表现，并非PowerShell特有逻辑。

相关术语 #

该行为对应的官方定义是自定义数字格式字符串零占位符（"0"格式说明符），属于.NET基类库标准格式化能力的一部分。

规则细节 #

1. 只有当字符串作为参数传入数值类型的ToString()方法、被识别为自定义数字格式串时，串中的0才会被当作占位符处理，其他场景下PowerShell不会自动替换普通字符串中的0。
2. 占位符替换逻辑：格式化器会从右往左匹配传入数值的每一位，对应位置的0会被替换为实际数字；如果数值位数不足，左侧多余的0占位符会被填充为字面量0；格式串中非格式说明符的内容（比如你写的test、_、未被识别为占位符的数字）默认会作为字面量直接输出。
3. 测试用例中出现的单/双引号输出差异，是PowerShell本身的字符串解析规则导致的：
   • 单引号'包裹的是字面量字符串，内容会原封不动传给ToString()方法
   • 双引号"包裹的是可展开字符串，PowerShell会在传参前先将串中的$_替换为当前管道对象的实际值，再把替换完成的字符串传给ToString()方法

测试用例输出对应解释 #

• 用例1：1..3 | ForEach-Object {$_.ToString('test_0_1')}
  单引号串原样传入，格式串中仅存在1个0占位符（test_后的0），该位置会被替换为当前数值1/2/3，后续_1为字面量直接保留，因此输出test_1_1/test_2_1/test_3_1。
• 用例2：1..3 | ForEach-Object {$_.ToString('test_0_0')}
  单引号串原样传入，格式串中存在两个被_分隔的0占位符。数值1/2/3均为1位，从右往左匹配时仅最右侧的0会被替换为实际数值，左侧的0因为没有对应高位数字，被填充为字面量0，因此输出test_0_1/test_0_2/test_0_3。
• 用例3：1..3 | ForEach-Object {$_.ToString("test_0$_\_0")}
  双引号串先做变量替换，传入ToString()的实际格式串为test_01_0/test_02_0/test_03_0。每个格式串中存在两个0占位符（01中的0、串尾的0），最右侧0替换为实际数值，左侧0因无对应高位补0，中间插入的1/2/3为字面量保留，因此输出test_01_1/test_02_2/test_03_3。
• 用例4：1..3 | ForEach-Object {$_.ToString("test_0$_\_$_")}
  双引号串先做变量替换，传入ToString()的实际格式串为test_01_1/test_02_2/test_03_3。每个格式串中仅存在1个0占位符（01/02/03中的0），该位置替换为实际数值，其余数字、下划线、文本均为字面量保留，因此输出test_11_1/test_22_2/test_33_3。

根据实际场景选择以下任意一种方案即可：

• 如果不需要做数字格式化，仅需要拼接固定字符串：直接使用PowerShell原生字符串插值/拼接即可，不要走ToString()的格式化重载，从根源上避免触发数字格式化逻辑，例如：

  1..3 | ForEach-Object {"test_0_1"}
  1..3 | ForEach-Object {"test_0_$_"}
  

• 如果需要使用ToString()做格式化，仅需要保留部分内容为字面量：将不需要解析的字面量部分用单引号包裹在格式串内，标记为纯文本不参与格式化解析，例如：

  1..3 | ForEach-Object {$_.ToString("'test_0_1'")}
  

• 如果需要保留格式串的转义逻辑：用.NET格式化规则的反斜杠转义所有0占位符，告诉格式化器该0是字面量而非占位符，例如：

  1..3 | ForEach-Object {$_.ToString('test\_0\_1')}
  

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