VSCode 1.19.3运行PowerShell脚本时注释行#$Var报错咨询

问题根源 #

你遇到的这个问题，本质是PowerShell解析逻辑在处理注释文本时的特殊行为：虽然注释行开头有#，但PowerShell解析器依然会扫描行内的特殊语法——当它看到$UPN:这种格式时，会把:当成变量作用域的分隔符（就像$env:Path里的:一样），但冒号后面没有合法的作用域或变量名，所以就抛出了「变量引用无效：':'后未跟有效变量名字符」的错误。

VSCode 1.19.3的PowerShell集成终端可能在执行脚本前的语法检查环节，比旧版本更严格地扫描了注释内容，才导致之前正常的脚本现在报错。

解决方案 #

你可以用以下几种方式修复这个问题，任选其一即可：

1. 转义注释里的$符号

在PowerShell里，用反引号`转义$，让解析器把它当成普通字符：

Function CreateNewE1User {
    #`$UPN: anvnamn & epostadress
    #`$Firstname: Förnamn
    #`$Lastname: Efternamn
    #`$Title: Medlemsnr inkl filialnrEUR
    #`$Displaynamn: Visningsnamn (Kedja Ort (Butiksnamn), Förnamn Efternamn KEDJA
    #`$PWD: Tillfälligt lösenord
    Param(
        $UPN,
        $Firstname,
        $Lastname,
        $Title,
        $Displaynamn,
        $PWD='Password01'
    )
    #skapa ny användare
    New-MsolUser -UserPrincipalName $UPN -FirstName $Firstname -LastName $Lastname -Title $Title -DisplayName $Displaynamn -UsageLocation "SE" -PasswordNeverExpires $false
}

2. 在$Var和:之间加空格

通过空格分隔变量名和冒号，让解析器不会把$UPN:当成一个整体的变量引用：

Function CreateNewE1User {
    #$UPN : anvnamn & epostadress
    #$Firstname : Förnamn
    #$Lastname : Efternamn
    #$Title : Medlemsnr inkl filialnrEUR
    #$Displaynamn : Visningsnamn (Kedja Ort (Butiksnamn), Förnamn Efternamn KEDJA
    #$PWD : Tillfälligt lösenord
    Param(
        $UPN,
        $Firstname,
        $Lastname,
        $Title,
        $Displaynamn,
        $PWD='Password01'
    )
    #skapa ny användare
    New-MsolUser -UserPrincipalName $UPN -FirstName $Firstname -LastName $Lastname -Title $Title -DisplayName $Displaynamn -UsageLocation "SE" -PasswordNeverExpires $false
}

3. 移除注释里的$符号

既然注释只是用来说明变量格式，去掉$也不影响可读性，这也是最直接的方式：

Function CreateNewE1User {
    #UPN: anvnamn & epostadress
    #Firstname: Förnamn
    #Lastname: Efternamn
    #Title: Medlemsnr inkl filialnrEUR
    #Displaynamn: Visningsnamn (Kedja Ort (Butiksnamn), Förnamn Efternamn KEDJA
    #PWD: Tillfälligt lösenord
    Param(
        $UPN,
        $Firstname,
        $Lastname,
        $Title,
        $Displaynamn,
        $PWD='Password01'
    )
    #skapa ny användare
    New-MsolUser -UserPrincipalName $UPN -FirstName $Firstname -LastName $Lastname -Title $Title -DisplayName $Displaynamn -UsageLocation "SE" -PasswordNeverExpires $false
}

补充说明 #

这种情况属于PowerShell解析器的“过度扫描”——虽然注释本身不会被执行，但解析器还是会检查其中的语法结构，避免潜在的解析错误。VSCode升级后，PowerShell扩展的语法检查逻辑可能做了调整，才让之前隐藏的问题暴露出来。

内容的提问来源于stack exchange，提问作者Anders Norén