PowerShell使用变量执行git checkout报错：pathspec不匹配已知文件

你看到的error: pathspec '?0c69153xxxxx'错误，核心是变量$commit_sha里包含不可见的特殊字符（比如UTF-8 BOM、开头的控制字符、换行符）。虽然你确认变量是String类型且内容看起来是正确的SHA，但Git实际收到的是带前缀特殊字符的字符串——因为Git会优先判断输入是否是合法的提交哈希/分支名，当识别失败时，就会把它当成文件路径（pathspec）去匹配，所以才报路径不匹配的错误。

1. 清理变量中的特殊字符 #

直接对变量做清洗，去掉多余字符：

# 去掉首尾所有空白、换行、控制字符
$commit_sha = $commit_sha.Trim()

# 更严格：只保留SHA允许的十六进制字符（0-9、a-f）
$commit_sha = $commit_sha -replace '[^0-9a-f]', ''

执行完清洗后再运行git checkout $commit_sha即可。

2. 强制Git识别为提交哈希 #

用--明确告诉Git后面的参数是提交引用，不是路径：

git checkout -- $commit_sha

3. 排查隐藏字符来源 #

如果想确认到底是什么特殊字符，可以用命令输出每个字符的ASCII编码：

$commit_sha.ToCharArray() | ForEach-Object { [int]$_ }

正常的SHA字符编码范围是48-57（0-9）、97-102（a-f），如果出现其他数值，就是对应的特殊字符。

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