xcopy
复制文件和目录，包括子目录。
有关如何使用此命令的示例，请参阅示例。
语法
xcopy <Source> [<Destination>] [/w] [/p] [/c] [/v] [/q] [/f] [/l] [/g] [/d [:MM-DD-YYYY]] [/u] [/i] [/s [/e]] [/t] [/k] [/r] [/h] [{/a | /m}] [/n] [/o] [/x] [/exclude:FileName1[+[FileName2]][+[FileName3]]] [{/y | /-y}] [/z] [/b] [/j] [/compress]
参数设置
| 参数 | 说明 |
|---|---|
| <Source> | 必需。 指定要复制的文件的位置和名称。 此参数必须包括驱动器或路径。 |
| [<Destination>] | 指定要复制的文件的目标。 此参数可以包括驱动器号后接冒号、目录名、文件名或这几项的组合。 |
| /W | 在开始复制文件之前显示以下消息并等待你的响应： 按任意键开始复制文件 |
| /p | 提示你确认是否要创建每个目标文件。 |
| /c | 忽略错误。 |
| /v | 在将每个文件写入目标文件时对其进行验证，以确保目标文件与源文件相同。 |
| /q | 禁止显示 xcopy 消息。 |
| /f | 复制时显示源文件名和目标文件名。 |
| /l | 生成要复制的文件列表，但不主动复制文件。 |
| /g | 当目标不支持加密时创建解密的目标文件。 |
| /d [:MM-DD-YYYY] | 仅复制在指定的日期或之后更改的源文件。 如果不包含 MM-DD-YYYY 值，则 xcopy 会复制比现有目标文件更新的所有源文件。 此命令行选项可用于更新已更改的文件。 |
| /u | 从仅存在于目标上的源复制文件。 |
| /i | 如果源是目录或包含通配符，并且目标不存在，则 xcopy 会假设目标指定了目录名，并会创建新目录。 然后，xcopy 将所有指定文件复制到新目录中。 默认情况下，xcopy 会提示你指定目标是文件还是目录。 |
| /s | 复制目录和子目录，除非它们是空的。 如果省略 /s，则 xcopy 在单个目录中运行。 |
| /e | 复制所有子目录，即使它们是空的。 将 /e 与 /s 和 /t 命令行选项结合使用。 |
| /t | 仅复制子目录结构（即树），而不复制文件。 若要复制空目录，必须包含 /e 命令行选项。 |
| /k | 复制文件，并保留目标文件的只读属性（如果存在于源文件上）。 默认情况下，xcopy 会删除只读属性。 |
| /r | 复制只读文件。 |
| /h | 复制具有隐藏文件和系统文件属性的文件。 默认情况下，xcopy 不会复制隐藏文件或系统文件 |
| /a | 仅复制设置了存档文件属性的源文件。 /a 不会修改源文件的存档文件属性。 有关如何使用 attrib 设置存档文件属性的信息，请参阅相关链接。 |
| /m | 复制设置了存档文件属性的源文件。 与 /a 不同，/m 会关闭源中指定的文件的存档文件属性。 有关如何使用 attrib 设置存档文件属性的信息，请参阅相关链接。 |
| /n | 使用 NTFS 短文件名或目录名创建副本。 将文件或目录从 NTFS 卷复制到 FAT 卷，或者当目标上需要 FAT 文件系统命名约定（即 8.3 命名规则字符）时，/n 是必需的。 目标文件系统可以是 FAT 或 NTFS。 |
| /o | 复制文件所有权和自由访问控制列表 (DACL) 信息。 |
| /x | 复制文件审核设置和系统访问控制列表 (SACL) 信息（隐含 /o）。 |
| /exclude:FileName1[+[FileName2]][+[FileName3]( )] | 指定文件列表。 必须至少指定一个文件。 每个文件都包含搜索字符串，而每个字符串都在文件的单独一行中。 当任何字符串与要复制的文件的绝对路径的任何部分匹配时，该文件将被排除在复制范围之外。 例如，指定字符串 obj 将排除目录 obj 下的所有文件，或扩展名为 .obj 的所有文件。 |
| /y | 禁止提示你确认覆盖现有目标文件。 |
| /-y | 提示你确认覆盖现有目标文件。 |
| /z | 以可重启模式通过网络复制。 |
| /b | 复制符号链接，而不复制文件。 此参数是在 Windows Vista® 中引入的。 |
| /j | 复制文件而不缓冲。 建议用于非常大的文件。 此参数是在 Windows Server 2008 R2 中添加的。 |
| /compress | 在文件传输期间请求网络压缩（如果适用）。 |
/[-]sparse |
启用或禁用在复制过程期间保留文件的稀疏状态。 如果同时指定了这两个参数，则 /-sparse 将覆盖 /sparse。 |
| /noclone | 不会尝试将区块克隆作为一种优化。 |
| /? | 在命令提示符下显示帮助。 |
备注
使用 /z
如果在复制阶段断开连接（例如，如果服务器脱机，则会断开连接），在重新建立连接后，复制将会恢复。 /z 还显示针对每个文件执行的复制操作的完成百分比。
在 COPYCMD 环境变量中使用 /y。
可以在 COPYCMD 环境变量中使用 /y。 可以在命令行中使用 /-y 来替代此命令。 默认会提示你是否要覆盖。
复制加密的文件
将加密的文件复制到不支持 EFS 的卷会导致错误。 首先解密文件，或者将文件复制到支持 EFS 的卷。
追加文件
若要追加文件，请为目标指定单个文件，但为源指定多个文件（即，使用通配符或 file1+file2+file3 格式）。
目标的默认值
如果省略目标，
xcopy命令会将文件复制到当前目录。指定目标是文件还是目录
如果目标不包含现有目录且不以反斜杠 (\) 结尾，则会显示以下消息：
Does <Destination> specify a file name or directory name on the target(F = file, D = directory)?如果你想要将一个或多个文件复制到某个文件，请按 F。 如果你想要将一个或多个文件复制到某个目录，请按 D。
可以使用 /i 命令行选项禁止此消息，这样，如果源是多个文件或目录，则
xcopy假设目标是目录。使用
xcopy命令设置目标文件的存档属性xcopy命令创建设置了存档属性的文件，无论该属性是否已在源文件中设置。 有关文件属性和 attrib 的详细信息，请参阅相关链接。比较
xcopy和diskcopy如果磁盘包含子目录中的文件，而你想将其复制到格式不同的磁盘上，请使用
xcopy命令而不是diskcopy。 由于diskcopy命令会逐轨复制磁盘，因此源磁盘和目标磁盘必须具有相同的格式。xcopy命令没有这一要求。 除非需要复制完整磁盘映像，否则请使用xcopy。内存不足错误
如果运行
xcopy复制文件名路径大于 255 个字符的文件或文件夹，则可能会出现“内存不足”错误。xcopy的退出代码若要处理
xcopy返回的退出代码，请在批处理程序的 if 命令行中使用 ErrorLevel 参数。 有关使用 if 处理退出代码的批处理程序示例，请参阅相关链接。 下表列出了每个退出代码和描述。退出代码 说明 0 文件已复制且未出错。 1 找不到要复制的文件。 2 用户已按下 CTRL+C 终止了 xcopy。4 发生了初始化错误。 内存或磁盘空间不足，或者在命令行中输入了无效的驱动器名称或无效的语法。 5 发生了磁盘写入错误。
示例
1. 若要将驱动器 A 中的所有文件和子目录（包括所有空子目录）复制到驱动器 B，请键入：
xcopy a: b: /s /e
2. 若要在以上示例中包括所有系统文件或隐藏文件，请添加 /h 命令行选项，如下所示：
xcopy a: b: /s /e /h
3. 若要使用 \Rawdata 目录中自 1993 年 12 月 29 日以来更改的文件更新 \Reports 目录中的文件，请键入：
xcopy \rawdata \reports /d:12-29-1993
4. 若要更新以上示例中 \Reports 中的所有文件（不考虑日期），请键入：
xcopy \rawdata \reports /u
5. 若要获取以上命令复制的文件的列表（即，不实际复制文件），请键入：
xcopy \rawdata \reports /d:12-29-1993 /l > xcopy.out
文件 xcopy.out 列出了要复制的每个文件。
6. 若要将 \Customer 目录及其所有子目录复制到网络驱动器 H: 上的目录 \\Public\Address，保留只读属性，并在 H: 上创建新文件时得到提示，请键入：
xcopy \customer h:\public\address /s /e /k /p
7. 要发出上一条命令，请确保 xcopy 在不存在 \Address 目录的情况下创建该目录，并禁止显示创建新目录时显示的消息，请添加 /i 命令行选项，如下所示：
xcopy \customer h:\public\address /s /e /k /p /i
8. 可以创建一个批处理程序来执行 xcopy 操作，并在发生错误时使用批处理 if 命令处理退出代码。 例如，以下批处理程序对 xcopy 源参数和目标参数使用可替换参数：
@echo off
rem COPYIT.BAT transfers all files in all subdirectories of
rem the source drive or directory (%1) to the destination
rem drive or directory (%2)
xcopy %1 %2 /s /e
if errorlevel 4 goto lowmemory
if errorlevel 2 goto abort
if errorlevel 0 goto exit
:lowmemory
echo Insufficient memory to copy files or
echo invalid drive or command-line syntax.
goto exit
:abort
echo You pressed CTRL+C to end the copy operation.
goto exit
:exit
若要使用上述批处理程序将 C:\Prgmcode 目录及其子目录中的所有文件复制到驱动器 B，请键入：
copyit c:\prgmcode b:
命令解释器将 %1 替换为 C:\Prgmcode，将 %2 替换为 B:，然后将 xcopy 与 /e 和 /s 命令行选项结合使用。 如果 xcopy 遇到错误，该批处理程序会读取退出代码并转到相应 IF ERRORLEVEL 语句中指示的标签，然后显示相应的消息并从批处理程序退出。
9. 此示例复制所有非空目录，以及在星号后带有关联文件扩展名的文件。
xcopy .\toc*.yml ..\..\Copy-To\ /S /Y
rem Output example.
rem .\d1\toc.yml
rem .\d1\d12\toc.yml
rem .\d2\toc.yml
rem 3 File(s) copied
在以上示例中，此特定源参数值 .\toc*.yml 复制相同的 3 个文件，即使删除此参数的两个路径字符 .\。 但是，如果从源参数中删除星号通配符（使之成为 .\toc.yml），则不会复制任何文件。