---
title: Unity Editor 命令行参数参考
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/zh-cn/engine/6000.0/manual/unity-editor/command-line-arguments/editor
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/unity-editor/command-line-arguments/editor.md
last_updated: 2026-11-12
generated_at: 2026-11-16T16:40:36.741Z
locale: zh-cn
---

# Unity Editor 命令行参数参考

> 从命令线启动 Unity Editor 版本When可以使用的Arguments列表。

您可以使用其他命令行参数启动 Unity Editor 和 Player，从而Control启动行为、配置Settings或自动化工作流程。

要使用这些Arguments，请在Terminal或命令提示符符启动When将它们附加到 Unity 可执行文件路径。例如：`unity.exe -batchmode -quit -executeMethod MyClass.MyMethod`。

有关更多信息，请参阅从命令行界面[运行 Unity](/engine/6000.0/manual/unity-editor/command-line-arguments/run-unity.md)。

* [配置参数](#configuration-arguments)
* [批次模式Arguments](#batchmode)
* [生成 Arguments](#build-arguments)
* [Unity Accelerator 缓存服务器 Arguments](#accelerator)
* [调试 Arguments](#debugging)
* [图形 API Arguments](#gfx-api-arguments)
* [许可证Arguments](#license-arguments)
* [金属Arguments（仅限macOS）](#metal-arguments-macos-only)
* [性能分析器参数](#profiler-arguments)
* [Unity Editor 特殊命令行参数](#unity-editor-special-command-line-arguments)
* [Unity Hub 特殊命令行参数](#unity-hub-special-command-line-arguments)
* [其他资源](#additional-resources)

## 配置Arguments##configuration-arguments

您可以运行 Unity Editor 并使用 ON 的其他命令和信息构建 Unity Applications 版本。Page面列出了可使用于启动和配置 Unity Editor 和 Unity Player 实例的命令行参数。

| **命令**                                                                                          | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-createProject <pathname>`                                                                     | 在给定路径处创建一个Empty Project。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `-cloneFromTemplate <template-path>`                                                            | 将 `-cloneFromTemplate` 与 `-createProject` 结合使用，使用 `-cloneFromTemplate` 指定的模板存档或目录，在 `-createProject` 指定的路径上新建 Project。示例（Windows）：`-createProject "C:\Projects\MyProject" -cloneFromTemplate "C:\Path\To\Templates\com.unity.template.urp-blank-17.1.0.tgz"`示例 (macOS)：`-createProject "/Users/username/Projects/MyProject" -cloneFromTemplate "/Users/username/Library/Application Support/UnityHub/Templates/com.unity.template.urp-blank-17.1.0.tgz"`示例 (Linux)：`-createProject "/home/username/Projects/MyProject" -cloneFromTemplate "/home/username/.config/UnityHub/Templates/com.unity.template.urp-blank-17.1.0.tgz"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `-consistencyCheck`                                                                             | ON Editor 启动时执行[导入器一致性检查](/engine/6000.0/manual/assets-and-media/import-assets/import-analyze/importer-consistency.md)。默认情况下 Unity 执行`local`检查，强制在本地重新导入 All Assets。它还会检查导入是否与上次导入不同。\*\*注意：\*\*一致性检查模式会禁用对 [Unity Accelerator](/engine/6000.0/manual/assets-and-media/importing-caching-assets/unity-accelerator.md) 的上传，旨在测试导入器输出是否具有确定性。如需了解更多信息，请参阅`-consistencyCheckSourceMode`的描述。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `-consistencyCheckSourceMode string`                                                            | 设置 Unity 比较资源导入When检查的音频源。请从以下值中进行选择：`local`：强制在本地Reimport导入AllAssets，并检查导入是否与上次导入不同。`cacheserver`：如果已启用 [Unity Accelerator](/engine/6000.0/manual/assets-and-media/importing-caching-assets/unity-accelerator.md)，此选项将从缓存服务器获取[资源元数据](/engine/6000.0/manual/assets-and-media/import-assets/asset-metadata.md)，并比较结果是否在本地 Match ON 缓存服务器。此选项仅重新导入缓存服务器器ON存在的Assets。如果一致性检查成功，则会保留原始导入result，并且不需要Upload，因为result是一致的并且已经缓存。如果检查失败，则会记录Editor器日志message，详细说明哪些导入failed。为了防止缓存缓存，不会上传不一致的result。有关更多信息，请参阅[ Check the consistency of an importer](/engine/6000.0/manual/assets-and-media/import-assets/import-analyze/importer-consistency.md)（检查导入器的一致性）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `-disable-assembly-updater <assembly1 assembly2>`                                               | 指定一个以Space分隔的程序程序集称列表作为 Unity ONAutomatic更新时忽略的Parameters。以Space分隔的程序集称列表是可选的：通道不带Any程序集名称的命令选项项以忽略All程序集，如示例 1 所示。**示例 1**`unity.exe -disable-assembly-updater`**示例 2**`unity.exe -disable-assembly-updater A1.dll subfolder/A2.dll`示例 2 有两个程序集名称，一个具有路径名。示例 2 会忽略`A1.dll`（无论它存储在哪个 Folder 中），并且仅当它存储在 `subfolder` Folder 下时才忽略`A2.dll`：如果在 `-disable-assembly-updater` 命令行参数中列出程序集（或者如果未指定程序集），Unity 会将以下 message 记录到 [Editor.log](/engine/6000.0/manual/scripting/debugging-and-diagnostics/log-files.md)：`[Assembly Updater] warning: Ignoring assembly [assembly_path] as requested by command line parameter.”).`使用此选项可避免导入程序集时不必要的 [API Updater](/engine/6000.0/manual/upgrade-guides/apiupdater.md) 开销。如果要导入访问不需要更新的 Unity API 的程序集，此参数很有用。When导入无法访问Any Unity API 的程序集时（例如，如果您在 Unity 外部构建了部分或All音频源代码，并希望将生成的程序集导入 Unity Project），此功能也很有用。**注意**：如果禁用Any需要更新的程序程序集的更新，可能会在编译时间、运行时时或两者同时出现难以轨道的错误。此参数仅禁用 [API Updater](/engine/6000.0/manual/upgrade-guides/apiupdater.md) 的 AssemblyUpdater 组件。API Updater 的 ScriptUpdater 组件仍然针对项目中的代码（包括包）运行，除非在没有 `-accept-apiupdate` 参数的批次模式下运行 Editor。有关更多信息，请参阅[批次模式 Arguments](#batchmode)。 |
| `-disable-gpu-skinning`                                                                         | 在启动时禁用图形处理单元 GPU 蒙皮。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `-executeMethod <ClassName.MethodName>` 或 `-executeMethod <NamespaceName.ClassName.MethodName>` | Unity 打Project以及可选Asset Server更新完成后，立即执行Static方法。您可以使用它执行 Continuous 集成、执行单元测试、进行构建或准备数据等任务。如果提供了`-activeBuildProfile`，Unity 会在运行 `-executeMethod` 之前使用配置文件的脚本定义来编译脚本。要从命令行进程返回报错，请抛出异常导致 Unity 使用返回代码 1 退出，或使用非零返回代码调用 [`EditorApplication.Exit`](/engine/6000.0/script-reference/unityeditor/editorapplication/exit.md)。要通道参数，请将它们添加到命令行并使用 `System.Environment.GetCommandLineArgs` 在函数中检索它们。要使用`-executeMethod`，必须将包含脚本放在 Editor Folder 文件夹中。执行的方法必须定义为 Static。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `-exportPackage <exportAssetPath1 exportAssetPath2 ExportAssetPath3 exportFileName>`            | 导出给定路径（或给定路径设置）的包。在此示例中，`exportAssetPath` 是要从 Unity Project 导出的文件夹（相对于 Unity Project 根），`exportFileName` 是 Package Name。此选项一时间仅导出整个文件夹。普通需要将此命令与 `-projectPath` 参数一起使用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `-importPackage <pathname>`                                                                     | 导入给定的[资源包](/engine/6000.0/manual/assets-and-media/asset-packages/create.md)。Unity 不显示Any导入对话框。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `-job-worker-count <N>`                                                                         | 指定 Unity JobQueue [任务工数量](/engine/6000.0/script-reference/unity/jobs/lowlevel/unsafe/jobsutility/jobworkermaximumcount.md)的最大线程数量。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `-gc-helper-count <N>`                                                                          | 指定资源垃圾回收器 helper 线程的数量。默值是可用的核心数量。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `-logFile <pathname>`                                                                           | 指定 Unity 将 Editor 日志文件写入的文件路径位置。ON 日志文件默认位置的更多信息，请参阅[日志文件参考](/engine/6000.0/manual/scripting/debugging-and-diagnostics/log-files.md)。要输出到控制台，请为路径 Name 指定`-`。ON Windows 可以使用 `-logFile` 将输出直接指向 [`stdout`](https://learn.microsoft.com/en-us/cpp/c-runtime-library/stdin-stdout-stderr?view=msvc-170)，默认情况下不是控制台。如果路径包含空格，请用双引号将其换行。即使路径不包含空格，某些命令线面也可能需要引用路径。示例（Windows）：`"C:\Program Files\Unity\Hub\Editor\<Version>\Editor\Unity.exe" -projectPath "C:\Projects\MyGame" -logFile "C:\Logs\Editor.log"`示例 (macOS)：`"/Applications/Unity/Hub/Editor/<Version>/Unity.app/Contents/MacOS/Unity" -projectPath "/Users/me/Projects/MyGame" -logFile "/Users/me/Logs/Editor.log"`示例 (Linux)：`"/opt/Unity/Hub/Editor/<Version>/Editor/Unity" -projectPath "/home/me/Projects/MyGame" -logFile "/home/me/logs/Editor.log"`要指定 UPM 背景应用程序的日志文件的位置，请参阅描述以`-upmLogFile`。                                                                                                                                                                                                                                                                              |
| `-noUpm`                                                                                        | 禁用 Unity 包管理器。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `-openfile <path>`                                                                              | 从Scene或包文件的路径OpenProject。或者，也可以使用 `-projectPath` 参数                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `-password <password>`                                                                          | 在激活 Unity Editor 期间，在日志表单中进入密码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `-projectPath <pathname>`                                                                       | 在给定路径处OpenProject，该路径可以是绝对路径，也可以是相对于当前工作目录的路径。如果路径名包含空格，请用引号将其括起来。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `-quit`                                                                                         | 在Other命令执行完毕后退出 Unity Editor。这样可以隐藏一些报错消息，但它们仍然显示在 Editor 的[日志文件](/engine/6000.0/manual/scripting/debugging-and-diagnostics/log-files.md)中。`-quit` 参数具有以下限制：如果 Editor 连接到 Accelerator 缓存服务器，则需要额外的参数`-cacheServerWaitForUploadCompletion`以防止 Unity 在未完成的缓存上传之前退出。如果 Editor 正在使用 `-runTests` 参数运行测试，则 `-quit` 会使 Editor 在 In-Progress 测试有机会完成之前立即退出。如果 Editor 正在运行异步代码，则`-quit`可能导致应用程序挂起并失去响应。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `-quitTimeout`                                                                                  | 当您使用 `-quit` 参数时，Editor 会等待待处理的异步任务以默认超时 300 秒完成。使用此参数可以设置不同的超时（以秒为单位）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `-releaseCodeOptimization`                                                                      | 启用释放代码优化模式，覆盖会话的当前默认代码优化模式。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 仅限 Android                                                                                      | 在导入纹理或版本Project之前，将默认纹理压缩设置为所需的Format。这是为了不必使用所需的 Format 再次导入纹理。可用格式为 dxt、PVRTC、ATC 等 ETC2 和 ASTC。已启用[纹理压缩定向](/engine/6000.0/manual/platform-specific/android/building-and-delivering/distribution/google-play.md#texture-compression-targeting)时，忽略此参数。\*\*注意：\*\*PVRTC Format 已弃用。使用 ASTC 或 ETC Format式。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `-overrideMaxTextureSize`                                                                       | 覆盖 Unity 在导入AssetsWhen应用的最大纹理大小（以像素为单位）。此设置会影响 Project 中的所有 Textures，并覆盖 [Texture Import Settings](/engine/6000.0/manual/materials-and-shaders/textures/textures-reference/class-texture-importer.md) 中为各个 Textures Configured 的任何 **Max Size**。该值是一个整数，表示纹理的高度或宽度（以较长者为准）的最大 Limit。调整宽WhenWhen。例如，如果纹理为 2048x1024 像素，但 `-overrideMaxTextureSize` 设置为 512，Unity 会导入大小为 512x256 像素的纹理。有关更多详细信息，请参阅[`EditorUserBuildSettings.overrideMaxTextureSize`](/engine/6000.0/script-reference/unityeditor/editoruserbuildsettings/overridemaxtexturesize.md)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `-overrideTextureCompression`                                                                   | 覆盖 Unity 导入AssetsWhen使用的纹理压缩Settings。在本地Development期间，这对于速度纹理导入或生成目标切换特别有用。有关细节，请参阅[`EditorUserBuildSettings.overrideTextureCompression`](/engine/6000.0/script-reference/unityeditor/editoruserbuildsettings/overridetexturecompression.md)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `-silent-crashes`                                                                               | 阻止 Unity 显示桌面版本，台式机，崩溃When显示的对话框。When希望在自动化构建或测试中运行播放Player时，此参数很有用，因为这种情况下不希望对话框提示阻碍自动化。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `-upmLogFile <pathname>`                                                                        | 指定 Unity 为独立于 Editor 运行的 UPM 背景应用程序程序编写日志文件的路径和文件Name。您可以在同一命令中指定 `-upmLogFile` 和 `-logFile`。如果同时包含这两个 Arguments，则可以为两个日志文件指定独立路径。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `-username <username>`                                                                          | 在 Unity Editor 激活期间，在日志表单中进入用户名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `-vcsMode <mode>`                                                                               | 设置版本控制模式。可用模式有 `"Visible Meta Files"`、`"Hidden Meta Files"`、`Perforce` 和 `PlasticSCM`。您可以使用其他标志来填写给定版本控制模式的配置字段。这些标志基于 [Provider.GetActiveConfigFields](/engine/6000.0/script-reference/unityeditor/versioncontrol/provider/getactiveconfigfields.md) 方法。例如，可以使用 `-vcPerforceUsername`、`-vcPerforcePassword`、`-vcPerforceWorkspace` 和 `-vcPerforceServer` 来设置 Perforce 用户名、工作空间和 Server 字段。**注意**：包含空格的 `<mode>` Arguments 必须用双引号 (") 括起来。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `-vcsModeSession <mode>`                                                                        | 设置此会话的版本控制模式。可用模式有 `"Visible Meta Files"`、`"Hidden Meta Files"`、`Perforce` 和 `PlasticSCM`。您可以使用其他标志来填写给定版本控制模式的配置字段。这些标志基于 [Provider.GetActiveConfigFields](/engine/6000.0/script-reference/unityeditor/versioncontrol/provider/getactiveconfigfields.md) 方法。例如，可以使用 `-vcPerforceUsername`、`-vcPerforcePassword`、`-vcPerforceWorkspace` 和 `-vcPerforceServer` 来设置 Perforce 用户名、工作空间和 Server 字段。**注意**：包含空格的 `<mode>` Arguments 必须用双引号 (") 括起来。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `-version`                                                                                      | 在命令线打印 Unity Editor 的版本数量，而不启动 Editor。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `-timestamps`                                                                                   | 以当前时间戳和线程 ID 作为每个 [Editor.log](/engine/6000.0/manual/scripting/debugging-and-diagnostics/log-files.md) message 的前缀。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

## 批次模式 Arguments##batch-mode-arguments

使用以下Arguments可配置 Unity 的批次处理模式。批次模式使 Unity 能够在没有用户输入的情况下运行预定义任务，这使得批次模式对于测试等自动化任务非常有用。

> **Important:**
>
> 除非与 Unity 另有单独的商业条款，否则以批次模式使用 Unity 将受 Unity 服务条款（包括适用的附加条款）的约束。有关更多信息，请参阅最新版本的 [Unity 服务条款](https://unity.com/legal/terms-of-service)和[其他条款，包括 Unity Editor 软件条款](https://unity.com/legal/additional-terms)。

| **命令**                  | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-accept-apiupdate`     | 使用此命令行选项可在以批次模式启动 Unity 时运行 [API Updater](/engine/6000.0/manual/upgrade-guides/apiupdater.md)。示例：`unity.exe -accept-apiupdate -batchmode [other params]`如果在批次模式下启动 Unity When忽略此命令线参数，则 API Updater 不会运行。这可能会导致编译器错误。                                                                                                                                                                                                                                                                                                                                                                             |
| `-batchmode`            | 以批处理模式运行 Unity。在批处理模式下，Unity 运行命令行参数，无需人机交互。它还禁止需要人机交互的对话 Windows（例如**保存场景**窗口）。使用命令行参数When，始终以批次处理模式运行 Unity，因为它允许自动化运行而不会中断。当脚本代码执行期间发生异常、Asset Server 更新失败或其他操作失败时，Unity 会立即退出并返回代码 **1**。在批次模式下，Unity 将其日志输出的最低版本发送到控制台。但是，[日志文件](/engine/6000.0/manual/scripting/debugging-and-diagnostics/log-files.md)仍然包含完整的日志信息。在 Editor 打开同一项目时，无法以批次模式打开项目；一次只能运行 Unity 的单一实例。要检查 Editor 还是桌面版本，台式机，请使用 [Application.isBatchMode](/engine/6000.0/script-reference/unityengine/application/isbatchmode.md) 运算符。如果 When using `-batchmode` 尚未导入 Project，则 Target 平台为默认平台。要强制不同的平台，请使用 `-buildTarget` 选项。 |
| `‑ignorecompilererrors` | 使用此参数When，即使存在编译错误，Unity 也会继续Start应用程序程序。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `-nographics`           | 在批次模式下运行When，Unity 不会Initialize图形设备。然后，您可以ON没有 GPU 的机器上运行自动化工作流程。自动工作流程仅在窗口获得焦点时才有效，否则无法发送模拟输入命令 `-nographics` 。 不允许烘焙 GI，因为 Enlighten Realtime Global Illumination 需要 GPU 进行 Meta Pass 渲染（请参阅 [光照贴图和着色器页面的 Meta Pass 部分](/engine/6000.0/manual/lighting-overview/lighting-birp/meta-pass.md) 以了解更多信息）。\*\*注意：\*\*输出日志在此模式OFF关闭。要启用输出日志的创建，请使用命令 `-logFile` 指定文件位置。                                                                                                                                                                                                                               |

## 生成 Arguments##build-arguments

使用以下Arguments可从命令线各种平台版本播放玩家。有关从命令行构建玩家的更多信息，请参阅从命令行[创建版本](/engine/6000.0/manual/building-and-publishing/build-customize-build-pipeline/build-command-line.md)。

| **命令**                                     | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-activeBuildProfile <pathname>`           | 将保存在给定路径处的[生成配置文件](/engine/6000.0/manual/building-and-publishing/build-settings/build-profiles.md)设置为 Active 生成配置文件（例如，`-activeBuildProfile "Assets/Settings/Build Profiles/WindowsDemo.asset"`）。**注意：**`-activeBuildProfile <pathname>` 在编译前应用 Active 生成配置文件的**生成数据**部分中的自定义脚本定义。这些脚本定义会添加到当前的定义设置中，并且不会重载或删除 Project 中的现有脚本定义。版本版本配置文件资源的路径必须相对于Project的根文件Folder。与 `-executeMethod` 一起指定时，Unity 会应用配置文件的脚本定义并在调用该方法之前触发脚本编译。配置文件的定义将添加到当前 Project 定义中，并在后续`-executeMethod`执行期间生效。这样可以实现 CI/CD 工作流程，例如在单一批次会话中切换 Target 平台。 |
| `-build <pathName>`                        | 从 `activeBuildProfile <pathname>` 到指定 Target 路径生成 Player。对于某些平台，路径必须以 Target 平台指定的文件扩展名结束。例如，`-build path/to/your/build.exe`。ON哪些平台需要扩展的信息，请参阅[平台版本路径参考](/engine/6000.0/manual/building-and-publishing/build-customize-build-pipeline/build-path-requirements.md)。                                                                                                                                                                                                                                                            |
| `-buildLinux64Player <pathname>`           | 生成 64 位独立平台 Linux Player（例如 `-buildLinux64Player path/to/your/build`）。                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `-buildLinuxHeadlessSimulation <pathname>` | 生成 64 位 Linux 无头模拟 Player（例如 `-buildLinuxHeadlessSimulation path/to/your/build`）。                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `-buildOSXUniversalPlayer <pathname>`      | 生成 64 位独立平台 macOS Player（例如 `-buildOSXUniversalPlayer path/to/your/build.app`）。                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `-buildTarget <name>`                      | 选择要在其中启动 Editor 的活动生成目标。可用的选项取决ON您在 Editor 中已启用了哪些版本目标。这些选项对应于 API 枚举[`BuildTarget`](/engine/6000.0/script-reference/unityeditor/buildtarget.md)中的可用选项，如下所示：`android``cloudrendering``ios``linux64``osxuniversal``tvos``visionos``windowsstoreapps``webgl``win``win64`如果您是可访问封闭平台的开发者，可能还有其他可用的`-buildTarget`选项。有关细节，请参阅 Target 平台的文档。                                                                                                                                                                                        |
| `-buildWindowsPlayer <pathname>`           | 生成 32 位独立平台 Windows Player（例如 `-buildWindowsPlayer path/to/your/build.exe`）。                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `-buildWindows64Player <pathname>`         | 生成 64 位独立平台 Windows Player（例如 `-buildWindows64Player path/to/your/build.exe`）。                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `-standaloneBuildSubtarget <name>`         | 在加载中Project之前，为独立平台平台选择一个Active的版本目标：玩家--server                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |

## Unity Accelerator 缓存服务器 Arguments##unity-accelerator-cache-server-arguments

使用以下 Arguments 可配置 Unity 对 [Unity Accelerator](/engine/6000.0/manual/assets-and-media/importing-caching-assets/unity-accelerator.md) 缓存服务器的使用。这些Arguments会重载 Editor 偏好 中存储的Any相应配置。

| **命令**                                                              | **描述**                                                                                                                                                                                                                                |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-EnableCacheServer`                                                | 启用 Unity Accelerator。还必须使用 `-cacheServerEndpoint <host:port>` 指定 Unity Accelerator 实例的地址。                                                                                                                                             |
| `-cacheServerEndpoint <host:port>`                                  | 指定 Unity Accelerator 实例的终端地址。示例：`-cacheServerEndpoint 127.0.0.1:10080`默认端口为 `10080`，但在安装过程中可以更改。                                                                                                                                      |
| `-cacheServerNamespacePrefix <prefix>`                              | 设置 Unity Accelerator 实例的命名空间前缀。使用此参数以及命名空间空间Name可对缓存服务器ON的数据进行分区，例如，隔离不同Projects Unity 版本的缓存数据。示例：`-cacheServerNamespacePrefix MyProject_Unity23LTS`包含空格的前缀必须用双引号 (`"`) 括起来。提供的Name用作缓存中最多 3 个Namespaces空间的前缀，这些命名空间按类型数瑕疵数据和着色器缓存数据。 |
| `-cacheServerEnableDownload true``-cacheServerEnableDownload false` | 启用或禁用从 Unity Accelerator 实例下载。                                                                                                                                                                                                        |
| `-cacheServerEnableUpload true``-cacheServerEnableUpload false`     | 启用或禁用上传到 Unity Accelerator 实例。示例：`-cacheServerEnableUpload true`                                                                                                                                                                      |
| `-cacheServerWaitForConnection <ms>`                                | 指定 Unity 在加载中Project等待连接到 Unity Accelerator 实例的时间（以毫秒为单位），然后开始初始ProjectRefresh。示例：`-cacheServerWaitForConnection 5000`                                                                                                                |
| `-cacheServerWaitForUploadCompletion`                               | 阻止 Unity 关闭，直到任Any处理的 Unity Accelerator 上传完成。当 Unity Accelerator 与命令行参数`-quit`结合使用时，建议这样做；命令行参数在其他脚本化命令执行完毕后关闭 Unity Editor。                                                                                                          |
| `-cacheServerDownloadBatchSize <batchSize>`                         | 设置各个缓存服务器DownloadBatches中的瑕疵数量。Download Batches 是一种优化，用于将单个下载分组为更大的 Batches，从而减少 Download 操作的数量。示例：`-cacheServerDownloadBatchSize 256`- 默认值为 1。                                                                                       |
| `-cacheServerUploadExistingImports`                                 | 当 Unity 开始将新建导入上传到 Unity Accelerator 实例时，上传以前未上传的任何现有导入。以前上传的导入不会重新上传。                                                                                                                                                                |
| `-cacheServerUploadAllRevisions`                                    | UploadAny现有导入，包括 Unity 开始将新建Upload传到 Unity Accelerator 实例When资源数据库已知但尚未上传的All先前修订版本。导入以前上传的修订版本，不会重新上传。                                                                                                                               |
| `-cacheServerUploadExistingShaderCache`                             | 在 Unity 开始将新建导入上传到缓存服务器时，上传以前未上传的任何现有着色器缓存导入。以前上传的着色器导入不会重新上传。                                                                                                                                                                        |

## 调试 Arguments##debugging-arguments

| **命令**                          | **描述**                                                                                                                                                                                                |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-disableManagedDebugger`       | 禁用调试器监听套接字。                                                                                                                                                                                           |
| `-diag-debug-shader-compiler`   | Unity 仅启动一个**着色器**编译器实例，并将其超时强制为一小时。可用于调试着色器编译器问题。                                                                                                                                                    |
| `-debugCodeOptimization`        | 启用调试代码优化模式，覆盖会话的当前默认代码优化模式。                                                                                                                                                                           |
| `-enableCodeCoverage`           | 启用 Code Coverage 并允许访问 [Coverage API](/engine/6000.0/script-reference/unityengine/testtools/coverage.md)。                                                                                             |
| `-force-d3d12-debug`            | 启用 DX12 验证图层。这对于处理 ON XR 插件或原生插件很有用。                                                                                                                                                                  |
| `-force-d3d12-debug-gbv`        | 启用基于 DX12 GPU 的验证。这对于处理 ON XR 插件或原生插件很有用。                                                                                                                                                             |
| `-force-vulkan-layers`          | 启用 Vulkan 验证图层。这对于处理 ON XR 插件或原生插件很有用。                                                                                                                                                                |
| `-stackTraceLogType`            | 允许 Detailed 调试。All Settings 允许选定 **None**、**Script Only** 和 **Full**（例如，`-stackTraceLogType Full`）。                                                                                                   |
| `-log-memory-performance-stats` | 在关闭Editor器When将Detailed的内存和性能Reports添加到 Unity Editor 主要日志文件中。                                                                                                                                         |
| `-wait-for-managed-debugger`    | 使 Editor 在启动之前等待Managed调试器附加。生成一个对话框，其中显示 Editor 的进程 ID。ON Managed 调试的更多信息，请参阅[在 Unity 中调试](/engine/6000.0/manual/scripting/debugging-and-diagnostics/managed-code-debugging.md#DebugInEditor) C# 代码。 |
| `-wait-for-native-debugger`     | 使 Editor 在启动之前等待附加原生调试器。生成一个对话框，其中显示 Editor 的进程 ID。                                                                                                                                                   |

## 图形 API Arguments##graphics-api-arguments

使用以下Arguments可力 Unity Editor 使用指定的的图形 API。

| **命令**                      | **描述**                                                                                                                                                                                                                                                                                                   |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-force-clamped`            | 将其与 `-force-glcoreXY` 结合使用可防止 Unity 检查其他 OpenGL 扩展，从而允许在具有相同代码路径的平台之间运行。此方法有助于确定问题是否由平台指定。例如，驱动程序错误。                                                                                                                                                                                                     |
| `-force-d3d11`（仅限 Windows）  | make Editor 使用 Direct3D 11 进行渲染。普通的图形 API 依赖于 **Player Settings**（通常默认为 D3D11）。                                                                                                                                                                                                                          |
| `-force-d3d12`（仅限 Windows）  | make Editor 使用 Direct3D 12 进行渲染。普通的图形 API 取决于 ON **Player Settings**。                                                                                                                                                                                                                                    |
| `-force-device-index`       | 通过向 Editor 传递特定 GPU 设备的索引，使 Editor 使用该设备。例如，使用此属性可力 Editor 使用集成的 GPU 而不是专用的 GPU。GPU 索索引和物理 GPU 之间的Mapping取决于System枚举 GPU 的Order。此枚举通常由正在使用的 GPU 驱动程序或底层框架（例如金属、Direct3D 或 Vulkan）执行 Done。普通，索引`0`将是连接到主 Monitor 的 GPU。ON 桌面计算机通常是专用 GPU，而 ON 笔记本电脑通常是集成 GPU。因此，桌面计算机的专用显卡通常是 ON `-force-device-index=0`。 |
| `-force-glcore`             | make Editor 使用 OpenGL 3/4 核心配置配置文件进行渲染。Editor 会尝试使用可用的最佳 OpenGL 版本以及 OpenGL 驱动程序程序公开的All OpenGL 扩展。如果平台不受支持，则 Editor 使用 Direct3D。                                                                                                                                                                        |
| `-force-glcoreXY`           | 与 类似`-force-glcore`，但需要指定的 OpenGL 上下文版本。XY 的接受值：32、33、40、41、42、43、44 或 45。如果平台不Support指定的版本的 OpenGL，Unity 将Fallback到支持的版本。                                                                                                                                                                               |
| `-force-gles`（仅限 Windows）   | make Editor 使用 OpenGL for 嵌入式 系统 进行渲染。Editor 会尝试使用可用的最佳 OpenGL ES 版本以及 OpenGL 驱动程序程序公开的All OpenGL ES 扩展。                                                                                                                                                                                                 |
| `-force-glesXY`（仅限 Windows） | 与`-force-gles`类似，但请求指定的 OpenGL ES 上下文版本。XY 的接受值：30, 31, 31aep 或 32。如果平台不Support OpenGL ES 的指定的版本，Unity 将Fallback到支持的版本。如果平台不Support OpenGL ES，Unity 将Fallback到另一个图形 API。                                                                                                                                 |
| `-force-opengl`             | make Editor 使用Legacy OpenGL 结束。                                                                                                                                                                                                                                                                          |
| `-force-vulkan`             | make Editor 使用 Vulkan 进行渲染。普通的图形 API 取决于 ON **Player Settings**。                                                                                                                                                                                                                                         |

## 许可证 Arguments##license-arguments

使用以下Arguments可以处理 Unity 许可证或使用不同的许可证选项运行 Unity Editor。

| **命令**                             | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-createManualActivationFile`      | 手动激活 Unity 许可证的[三步骤过程](/engine/6000.0/manual/get-started/install-and-upgrade/licenses-and-activation/manual-license-activation/manual-activation-guide.md)的第一步。有关更多信息，请参阅[用户手册许可证激活](/engine/6000.0/manual/get-started/install-and-upgrade/licenses-and-activation/manual-license-activation/manual-activation-guide.md)。                                                                                                                                                                             |
| `-manualLicenseFile <yourulffile>` | 手动激活 Unity 许可证的[三步骤过程](/engine/6000.0/manual/get-started/install-and-upgrade/licenses-and-activation/manual-license-activation/manual-activation-guide.md)中的步骤三。有关更多信息，请参阅[用户手册许可证激活](/engine/6000.0/manual/get-started/install-and-upgrade/licenses-and-activation/manual-license-activation/manual-activation-guide.md)。                                                                                                                                                                            |
| `-returnlicense`                   | 返回当前Active的基于序列或命名的用户许可证证。不要使用`-returnlicense`返回浮动许可证。有关更多信息，请参阅[退回许可证](/engine/6000.0/manual/get-started/install-and-upgrade/licenses-and-activation/managing-your-unity-license.md#license-return-cli)。有关许可模式的更多信息，请参阅 [Licensing Overview](/engine/6000.0/manual/get-started/install-and-upgrade/licenses-and-activation/license-overview.md)。                                                                                                                                                     |
| `-serial <serial-key>`             | 激活付费 Unity 许可证。包含 `<serial-key>` 值可激活基于序列号的许可证，或同时激活指定的用户许可证及其 serial Key。排除 `<serial-key>` 值以激活指定的用户许可证而不激活其 serial Key。有关更多信息，请参阅从命令行[激活许可证](/engine/6000.0/manual/get-started/install-and-upgrade/licenses-and-activation/managing-your-unity-license.md#license-activation-cli)。有关许可模式的更多信息，请参阅 [Licensing Overview](/engine/6000.0/manual/get-started/install-and-upgrade/licenses-and-activation/license-overview.md)。\*\*注意：\*\*使用 `-serial` 参数时，还必须使用 `-batchmode` 参数。指定 `-quit` 参数也是一种很好的做法。 |

## 金属 Arguments（仅限 MacOS）##metal-arguments-(macos-only)

使用以下 Arguments 可配置 Unity 对 Apple Devices 使用[金属](/engine/6000.0/manual/platform-specific/cross-platform-features/graphics-apis/metal.md)图形 API。

| **命令**                              | **详细信息**                            |
| ----------------------------------- | ----------------------------------- |
| `-force-low-power-device`（仅限 macOS） | 如果使用 金属，make Editor 使用低功耗设备。        |
| `-force-metal`                      | make Editor 使用 金属 作为图形PI（仅限 macOS）。 |
| `-enable-metal-capture`             | 启用从 Editor 内部获取金属捕获的功能。             |

## 性能分析器 Arguments##profiler-arguments

使用以下 Arguments 可配置 Unity 对性能[分析器](/engine/6000.0/manual/analysis/profiler.md)的使用。

| **命令**                                           | **描述**                                                                                                                                                                                                                                                      |
| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-deepprofiling`                                 | 为 [CPU 性能分析器](/engine/6000.0/manual/analysis/profiler/window.md)启用深度性能分析选项。                                                                                                                                                                                 |
| `-profiler-enable`                               | 对 Player 或 Editor 的 Start 进行配置文件。将此参数与 Player 一起使用时，其特效与在[生成配置文件](/engine/6000.0/manual/building-and-publishing/build-settings/build-profiles.md)中已启用 **Autoconnect Profiler** 选项的情况下构建 Player 的效果相同。将此参数与 Editor 一起使用时，Editor 启动时会在性能分析器窗口中开始收集和显示性能分析器信息。 |
| `-profiler-log-file <Path/To/Log/File.raw>`      | 此参数设置 [Unity Profiler](/engine/6000.0/manual/analysis/profiler.md) 在启动时将配置文件数据流到 .原始文件。它适用于玩家和 Editor。                                                                                                                                                      |
| `-profiler-capture-frame-count <NumberOfFrames>` | 此参数设置启动时串流到 .原始文件时性能分析器应在配置文件中捕获的帧数。仅适用于 ON 玩家。                                                                                                                                                                                                             |
| `-profiler-maxusedmemory`                        | 默认情况下，Unity Profiler 的`maxUsedMemory`对于玩家为 16MB，对于 Editor 为 256MB。您可以使用此参数在 Start 时将 `maxUsedMemory` 参数设置为自定义大小（例如，`-profiler-maxusedmemory 16777216`）。大小以字节为单位设置。                                                                                          |

## Unity Editor 特殊命令行参数##unity-editor-special-command-line-arguments

仅在特殊情况下或 Unity 支持部门指示When才使用。

| **命令**                              | **描述**                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-enableIncompatibleAssetDowngrade` | WhenAssets由更新、不兼容的 Unity 版本制作，并且要降级才能与当前 Unity 版本配合使用，请使使用此选项。Enable此属性When，如果尝试Open需要此属性的Project，Unity 会显示一个对话框，要求确认此降级。注意：此过程不受支持且风险很高，只能用作最后的手段。                                                                                                                                                                                                           |
| `-giCustomCacheLocation`            | 设置[全局光照 (GI) 缓存](/engine/6000.0/manual/lighting-overview/direct-and-indirect-lighting/lightmap-data/gicache.md)文件夹的自定义位置。值必须是绝对路径，如果包含Any空格，则必须将其包含在引号中。如果设置了 `-giCustomCacheLocation`，则对于当前 Editor 会话，其值覆盖先前在 [GI Cache 偏好](/engine/6000.0/manual/unity-editor/editor-settings-reference/preferences/gi-cache.md)中定义的任何自定义**缓存 Folder 位置**。Editor 退出后，值不再存在。 |
| `-rebuildLibrary`                   | 此过程会删除 `Library` Project 子目录，从而触发 All Assets 的完整 Reimport。When Unity 在Project初始化期间Reports数据库损坏报错时，请使使用此选项。                                                                                                                                                                                                                                                    |

## Unity Hub 特殊命令行参数##unity-hub-special-command-line-arguments

仅在特殊情况下或 Unity 支持部门指示When才使用。这些Arguments默认情况下情况下不使用 Unity Hub Unity Editor 版本中使用。

| **命令**          | **描述**                                |
| --------------- | ------------------------------------- |
| `-useHub`       | 启动与 Hub 集成的 Unity Editor。             |
| `-hubIPC`       | 启用 Unity Editor 和 Unity Hub 之间的通信和交互。 |
| `-hubSessionId` | 指定 Unity Hub 会话的唯一标识符。                |

在 Unity Editor 的All受支持版本中，这些Arguments都已默认情况下设置。

## 其他资源##additional-resources

* [从命令行创建版本](/engine/6000.0/manual/building-and-publishing/build-customize-build-pipeline/build-command-line.md)
* [Android Player 命令行 Arguments](/engine/6000.0/manual/platform-specific/android/developing/application-entries/activity/unity-player-activity/custom-activity-command-line.md)
* [在命令行上使用 Unity Accelerator](/engine/6000.0/manual/assets-and-media/importing-caching-assets/accelerator-command-line.md)
* [从命令行为嵌入式 Linux 生成](/engine/6000.0/manual/platform-specific/embedded-systems/embedded-linux/build-and-deliver/command-line.md)
* [从命令行为 QNX 生成](/engine/6000.0/manual/platform-specific/embedded-systems/qnx/build-and-deliver/build-command-line.md)
* [Test Framework 命令行 Arguments 参考](/engine/6000.0/manual/reference-command-line.md)
* [性能分析器命令行 Arguments 参考](/engine/6000.0/manual/analysis/profiler/command-line-arguments.md)
* [从命令行运行 Project Auditor](/engine/6000.0/manual/run-from-command-line.md)
