先给结论

where mytool
where /R E:\cmd-demo\where mytool
echo %PATH%
set "PATH=E:\cmd-demo\where\bin1;%PATH%"
setx CMD_DEMO_WHERE_TMP two
  • 这句报错只说明:cmd 在当前目录和 PATH 里都没找到能执行的文件。程序多半装了,只是没进 PATH,或者名字、扩展名不对。
  • where 按 PATH 顺序列出所有同名程序。找到退出码 0;找不到打「信息: 用提供的模式无法找到文件。」,退出码 1。where /q 不打印,只留退出码。
  • where 不只看 PATH,当前目录排在输出第一行;where /R 完全不看 PATH,从指定目录往下递归翻。
  • PATH 是分号分隔的一整串路径。漏写分号,两条路径会粘成一条;末尾多写分号没有影响;路径带空格不用加引号,加了反而找不到。
  • set 只改当前窗口。setx 写注册表,当前窗口不变,新开的窗口才读到;值超过 1024 字符会被裁断,而且照样返回成功。
  • 用户变量和系统变量同名时,用户覆盖系统;PATH 是例外,等于系统 PATH 后面接用户 PATH。
  • 程序在 C:\Program Files 这类带空格的目录里,直接敲完整路径会在空格处断开,要么加引号,要么先 cd /d 进去。
  • 脚本里定位程序:%~dp0 找脚本自己所在目录,pushd 临时切目录,for %%~$PATH:I 或 where /q 查 PATH。

「不是内部或外部命令」不是权限问题,也不是装失败。先敲 where,看它到底在哪些目录找过。

演示用的目录结构

全文都在 E:\cmd-demo\where 里操作,路径就是本机真实路径。同目录的 setup.ps1 会重建下面这棵树,每段示例都从重建后的状态开始;测试文件保留,不清理。

E:\cmd-demo\where
├── setup.ps1
├── bin1
│   └── mytool.cmd
├── bin2
│   └── mytool.cmd
├── Program Files
│   └── mytool.cmd
├── local
│   └── mytool.cmd
└── scripts
    ├── run-dp0.cmd
    ├── find-path.cmd
    ├── run-pushd.cmd
    └── has-tool.cmd

四个 mytool.cmd 内容不同:bin1 打 mytool v1,bin2 打 mytool v2,local 打 mytool local,Program Files 打 mytool program files,一跑就能看出执行的是哪个。


一、where:先确认程序在不在

把两个演示目录接到 PATH 前面,再查:

set "PATH=E:\cmd-demo\where\bin1;E:\cmd-demo\where\bin2;%PATH%"
where mytool

输出:

E:\cmd-demo\where\bin1\mytool.cmd
E:\cmd-demo\where\bin2\mytool.cmd

退出码 0。两行都是完整路径,说明 PATH 里两个目录都命中。

换一个不存在的名字:

where nope

输出:

信息: 用提供的模式无法找到文件。

这句在 stderr,退出码 1。注意它没说「不是内部或外部命令」——where 自己找得到自己,报的是「没匹配到文件」。

脚本里只想知道有没有,用 /q:

where /q nope
if errorlevel 1 echo not found

输出:

not found

where /q 本身不打印任何东西,找到返回 0,找不到返回 1。上面整行退出码是 0,因为最后一条 echo 成功了;判断要看紧跟 where /q 的那个 errorlevel。

还有个自指的坑:如果把 PATH 整个替换成只有演示目录,连 where 都会消失,报的是 'where' 不是内部或外部命令,也不是可运行的程序或批处理文件。。所以改 PATH 永远用 %PATH% 往后接,不要整体覆盖。

截图


二、where /R:不依赖 PATH,直接翻目录

where 只在 PATH 和当前目录里找。记不清装哪了,用 /R 从某个根往下翻:

where /R E:\cmd-demo\where mytool

输出:

E:\cmd-demo\where\bin1\mytool.cmd
E:\cmd-demo\where\bin2\mytool.cmd
E:\cmd-demo\where\local\mytool.cmd
E:\cmd-demo\where\Program Files\mytool.cmd

四个全出来了,包括不在 PATH 里的 local 和 Program Files。/R 不看 PATH,只认给的根目录,递归到底。

名字可以不写扩展名,mytool 能匹配到 .cmd,因为 where 会按 PATHEXT 补扩展名。找不到时还是那句「信息: 用提供的模式无法找到文件。」,退出码 1。

/R 很慢,从 C:\ 开始翻更慢,记得大概范围再用。

截图


三、同名程序,谁先被用

PATH 里放两个同名程序,顺序决定结果:

set "PATH=E:\cmd-demo\where\bin1;E:\cmd-demo\where\bin2;%PATH%"
where mytool
mytool

输出:

E:\cmd-demo\where\bin1\mytool.cmd
E:\cmd-demo\where\bin2\mytool.cmd
mytool v1

把顺序换过来,重建后重跑:

set "PATH=E:\cmd-demo\where\bin2;E:\cmd-demo\where\bin1;%PATH%"
where mytool
mytool

输出:

E:\cmd-demo\where\bin2\mytool.cmd
E:\cmd-demo\where\bin1\mytool.cmd
mytool v2

where 的第一行就是实际执行的那个,输出顺序可以当依据。

但当前目录永远排在 PATH 前面:

cd /d local
set "PATH=E:\cmd-demo\where\bin1;%PATH%"
where mytool
mytool

输出:

E:\cmd-demo\where\local\mytool.cmd
E:\cmd-demo\where\bin1\mytool.cmd
mytool local

这也是「PATH 改对了却跑旧版本」的常见原因:当前目录躺着同名文件。排查时先 where,看第一行是不是你要的目录。

截图


四、PATH 拼接:漏分号、加引号、末尾分号

漏写分号。 最常见的写法错误:

set "PATH=%PATH%E:\cmd-demo\where\bin1"
where mytool

输出:

信息: 用提供的模式无法找到文件。

退出码 1。原来的最后一项和 E:\cmd-demo\where\bin1 粘成了一条不存在的路径,等于白加。where 还能跑,因为系统目录还在 PATH 里。

空格路径加引号。 看到空格就想加引号,结果引号被当成了路径的一部分:

set PATH="E:\cmd-demo\where\Program Files";%PATH%
where mytool

输出:

信息: 用提供的模式无法找到文件。

退出码 1。PATH 里存的是 "E:\cmd-demo\where\Program Files",带引号的那串目录并不存在。

空格路径不加引号才是对的:

set "PATH=E:\cmd-demo\where\Program Files;%PATH%"
where mytool
mytool

输出:

E:\cmd-demo\where\Program Files\mytool.cmd
mytool program files

PATH 是分号分隔的,空格不是分隔符,整条路径照原样存进去就行。外层那对引号是给 set 的,防止 &、| 之类的字符被提前解释,不会进入变量值。

末尾多写分号没有影响:

set "PATH=E:\cmd-demo\where\bin1;%PATH%;"
where mytool
mytool

输出:

E:\cmd-demo\where\bin1\mytool.cmd
mytool v1
写法 结果 退出码
set "PATH=%PATH%E:\cmd-demo\where\bin1" 「信息: 用提供的模式无法找到文件。」 1
set PATH="E:\cmd-demo\where\Program Files";%PATH% 引号进了路径,找不到 1
set "PATH=E:\cmd-demo\where\Program Files;%PATH%" 正常执行 0
set "PATH=E:\cmd-demo\where\bin1;%PATH%;" 正常执行 0

截图


五、set 只改当前窗口,setx 写注册表

set 设的变量,只在当前这个 cmd 进程里有效:

set CMD_DEMO_WHERE_TMP=one
set CMD_DEMO_WHERE_TMP

输出:

CMD_DEMO_WHERE_TMP=one

另开一个窗口再查:

set CMD_DEMO_WHERE_TMP

输出:

环境变量 CMD_DEMO_WHERE_TMP 没有定义

退出码 1。这是 set 和 setx 最大的区别:set 改的是本进程的环境块,窗口一关就没了。

setx 写进用户环境变量(注册表 HKCU\Environment),但当前窗口不会变:

setx CMD_DEMO_WHERE_TMP two

输出:

成功: 指定的值已得到保存。

当前窗口再查,还是旧值:

set CMD_DEMO_WHERE_TMP

输出:

CMD_DEMO_WHERE_TMP=one

注册表里已经是新值:

reg query HKCU\Environment /v CMD_DEMO_WHERE_TMP

输出:

HKEY_CURRENT_USER\Environment
    CMD_DEMO_WHERE_TMP    REG_SZ    two

新开一个窗口,才读到:

set CMD_DEMO_WHERE_TMP

输出:

CMD_DEMO_WHERE_TMP=two

进程的环境块在启动那一刻就固定了。setx 改的是注册表,再广播一条变更消息,只有之后新建的进程才会重新读;已经开着的窗口、正在跑的脚本,都还是旧值。

setx 有长度上限。用一个 1100 个字符的值测试,stderr 打的是:

警告: 正保存的数据被裁断到 1024 字符。

stdout 仍然打「成功: 指定的值已得到保存。」,退出码 0。查注册表,实际存了 1024 个字符。超长不会失败,只会悄悄截断。

测试完把临时变量删掉:

reg delete HKCU\Environment /v CMD_DEMO_WHERE_TMP /f

输出:

操作成功完成。

setx 默认写用户变量,加 /M 才写系统变量(需要管理员)。别用它改 PATH:实测把当前 %PATH% 整条写进一个临时变量,值在 1024 字符处被从中间截断,退出码仍是 0。改 PATH 更稳的是在「系统属性」里改。

截图


六、用户变量和系统变量,谁覆盖谁

同一个名字在两个地方都有,先看注册表:

reg query HKCU\Environment /v TEMP

输出:

HKEY_CURRENT_USER\Environment
    TEMP    REG_EXPAND_SZ    %USERPROFILE%\AppData\Local\Temp
reg query "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v TEMP

输出:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment
    TEMP    REG_EXPAND_SZ    %SystemRoot%\TEMP

系统给的是 %SystemRoot%\TEMP,用户自己又定义了一份。实际用的是哪个:

echo %TEMP%

输出:

C:\Users\jsx13\AppData\Local\Temp

用户变量赢了。普通变量同名时,用户变量覆盖系统变量。

PATH 是例外:它不是覆盖,而是拼接。系统 PATH 的条目排在前面,用户 PATH 的条目接在后面。往用户 PATH 里加目录,永远排在系统目录之后;想抢先,只能改系统 PATH 或者临时 set 顶到最前面。

截图


七、程序在 Program Files 里,直接敲名字会怎样

完整路径里有空格,不加引号:

E:\cmd-demo\where\Program Files\mytool.cmd

输出:

'E:\cmd-demo\where\Program' 不是内部或外部命令,也不是可运行的程序
或批处理文件。

退出码 1。报错里那个 'E:\cmd-demo\where\Program' 就是断点:cmd 在空格处把路径切成了两段,拿前半段当命令名。

加引号就能跑:

"E:\cmd-demo\where\Program Files\mytool.cmd"

输出:

mytool program files

也可以先切进去,再敲名字,这时不需要引号:

cd /d "E:\cmd-demo\where\Program Files"
mytool

输出:

mytool program files

cd /d 后面仍要引号,那是 cd 自己的解析规则;进了目录之后 mytool 是单个词,不会再被切开。

第三种办法是把这个目录加进 PATH,前面已经验证过,不带引号是能用的。

这也是「桌面双击能开、命令行敲名字不行」的原因:快捷方式里存的是带引号的完整路径。

截图


八、脚本里怎么定位程序

写死 E:\cmd-demo\where\bin1\mytool.cmd 最省事,但脚本一挪位置就废。%~dp0 是脚本自己所在目录,带尾部反斜杠:

E:\cmd-demo\where\scripts\run-dp0.cmd

输出:

E:\cmd-demo\where\scripts\
mytool v1

第一行是脚本里 echo %~dp0 的结果,第二行是 call "%~dp0..\bin1\mytool.cmd" 的输出。%~dp0 天然带结尾的反斜杠,拼上级目录写成 %~dp0..\bin1,不用自己补。

需要临时切到程序目录时用 pushd,它把原目录压栈,popd 还原,还支持 UNC 路径:

E:\cmd-demo\where\scripts\run-pushd.cmd

输出:

mytool v1

程序不在脚本旁边,而在 PATH 里,可以用 for 的 %~$PATH:I 查它的完整路径:

E:\cmd-demo\where\scripts\find-path.cmd

输出:

E:\cmd-demo\where\bin1\mytool.cmd

找到就是完整路径,找不到展开为空。只想判断有没有,用 where /q 加 errorlevel 更直观:

E:\cmd-demo\where\scripts\has-tool.cmd

输出:

E:\cmd-demo\where\bin1\mytool.cmd
手段 适用场景 注意
%~dp0 程序跟脚本一起分发 带尾部反斜杠;路径含空格时外层要加引号
pushd "%~dp0..\bin1" 需要先切工作目录 配对 popd,否则目录越切越深
for %%I in (名字) do %%~$PATH:I 程序在 PATH 里,要拿完整路径 找不到时展开为空
where /q 名字 只要判断存在性 依赖 PATH,不查当前目录以外的位置

截图


九、报错速查表

报错或现象 原因 处理
'xxx' 不是内部或外部命令,也不是可运行的程序或批处理文件。 当前目录和 PATH 都没有这个可执行文件 where xxx 看找过哪里;补 PATH 或写全路径
'E:\cmd-demo\where\Program' 不是内部或外部命令,也不是可运行的程序或批处理文件。 带空格的路径没加引号,在空格处被切断 整个路径加引号,或先 cd /d
信息: 用提供的模式无法找到文件。 where 没匹配到 换 /R 指定根目录;核对名字和 PATHEXT
'where' 不是内部或外部命令,也不是可运行的程序或批处理文件。 PATH 被整体替换,系统目录丢了 用 %PATH% 追加,不要覆盖
环境变量 XXX 没有定义 变量只存在于别的窗口或还没生效 setx 后新开窗口;或先 set 临时用
警告: 正保存的数据被裁断到 1024 字符。 setx 值超长 减短,或改用图形界面改 PATH
命令找得到,版本却不对 PATH 里有多个同名程序,或当前目录有同名文件 where 看第一行

脚本里判断命令是否存在,用 where /q 名字 加 if errorlevel 1,别用 echo %ERRORLEVEL%:一行命令里它会提前展开。setx 即便因为超长被截断也返回 0,别拿退出码判断有没有写完;reg query 查不到返回 1。

下一篇

where 解决的是「知道名字,但不知道命令装在哪」;下一篇换一个问题:如果连文件叫什么、放在哪个子目录都不确定,where 就不够用了,得把文件本身找出来。dir /s /b、/a、通配符、where /R、for /r、forfiles /S 各管什么,它们对隐藏文件、带空格的路径和无匹配退出码的处理并不一致,结果常常比想象中少几个或多几个。