科技 · 实用指南
PowerShell 的 Docker 报 invalid reference format？先找真正的镜像参数
挂载路径或续行错误可能把别的内容挤到镜像位置。先核终端版本与参数边界，再考虑镜像名和标签，不要乱清数据。
invalid reference format 不一定说明你想用的镜像名错误。docker run 的顺序是选项、镜像、容器命令；PowerShell 引号或续行出错，会把另一个参数送进镜像位置。重建或清理之前，先确定实际命令边界。
确认实际终端和可执行文件
在报错会话记录 $PSVersionTable.PSVersion 和 Get-Command docker -All；7.3及以后再记录 $PSNativeCommandArgumentPassing。Windows PowerShell5.1与新版原生引号行为不同，变量缺失不能当成Standard模式。
保存完整错误与脱敏原命令，保留换行。先区分PowerShell的无法识别-v与Docker引用解析错误。收证时别公开整个环境、密码或镜像仓库凭据。
不启动容器，也能先标出镜像位置
按官方顺序 docker run [OPTIONS] IMAGE [COMMAND] [ARG...]，逐一配对选项及其值，再找IMAGE。挂载字符串若被拆开，剩余片段可能落到镜像位置。IMAGE之后的标志通常属于容器命令，不是Docker配置。
可用不执行的示例 $image = 'example.com/team/app:Release_1' 及 $dockerArgs = @('run','--rm',$image)，逐项查看数组。占位名称只展示语法，不代表真实镜像。再逐项加入脱敏选项和值；别为了打印数组调用docker。预览仍不能证明原生进程实际接收的参数。
按当前PowerShell重建引号
先手打最小单行命令，排除复制带来的续行和花式符号。PowerShell显式续行用反引号，后面有空格就会断；Bash反斜线或cmd.exe脱字符不能混用。含空格参数要保持整体，而不是只引住挂载表达式一部分。
微软说明7.3起Legacy、Standard、Windows模式的行为差异，不应先全局改模式。--%也会限制普通变量展开，且遇换行或管道结束，不是动态路径万能修复。.cmd包装脚本还可能增加直接docker.exe没有的解析层。
核引用后，再验证原本要做的事
确认真正镜像参数后，与发布者原引用逐字比较。仓库路径用正斜线；规范限制路径字母小写，但标签规则不同，可含大写。别把整个引用转小写、改标签或去摘要来压下错误。
传参仍不清楚时，用可信参数检查工具在同一终端和包装路线测无秘密的合成值，微软文档示例为TestExe。随后只执行原计划且获准的Docker操作并核结果。解析通过不证明挂载正确、仓库可访问或应用健康。本文未实测Windows或运行容器，删镜像、卷和凭据也不能修复分词。
