命令行界面 (CLI)

Visual Studio Code 内置了一个强大的命令行界面，使您可以控制如何启动编辑器。您可以打开文件、安装扩展、更改显示语言，并通过命令行选项（开关）输出诊断信息。

如果你正在寻找如何在 VS Code 内运行命令行工具，请参阅 集成终端。

命令行帮助

要了解 VS Code 命令行界面的概览，请打开终端或命令提示符并输入代码 --help您将看到版本、使用示例和命令行选项列表。

从命令行启动

您可以从命令行启动 VS Code 以快速打开文件、文件夹或项目。通常，您在文件夹上下文中打开 VS Code。为此，请在打开的终端或命令提示符中导航到您的项目文件夹并键入代码输入：

Windows 和 Linux 安装应将 VS Code 二进制文件的位置添加到您的系统路径中。如果不是这样，您可以手动将位置添加到路径环境变量 ($PATH在 Linux 上）。例如，在 Windows 上，VS Code 默认二进制文件位置是AppData\Local\Programs\Microsoft VS Code\bin。要查看特定平台的设置说明，请参见设置。

核心 CLI 选项

以下是在命令行通过启动 VS Code 时可以使用的可选参数代码输入：

打开文件和文件夹

有时您可能需要打开或创建一个文件。如果指定的文件不存在，VS Code 将为您创建它们以及任何新的中间文件夹：

代码 index.html style.css 文档\readme.md

对于文件和文件夹，您可以使用绝对或相对路径。相对路径是相对于您运行命令提示符的当前目录。代码输入：.

如果你在命令行中指定多个文件，VS Code 只会打开一个实例。

如果你在命令行中指定多个文件夹，VS Code 将创建一个多根工作区，包括每个文件夹。

选择一个配置文件

你可以通过 特定配置文件 启动 VS Code--配置文件命令行界面选项。您在后面传递配置文件的名称。--配置文件参数并使用该配置文件打开一个文件夹或一个工作区。下面的命令行打开网页样本包含"Web Development"配置文件的文件夹：

代码 ~/projects/web-sample --profile "Web Development"

如果指定的配置文件不存在，则创建一个具有指定名称的新空配置文件。

使用扩展

你可以通过命令行安装和管理VS Code扩展。

从命令行开始聊天

您可以通过使用直接从命令行启动聊天会话聊天在 VS Code CLI 中使用子命令。这使您能够在当前工作目录中通过您提供的提示开始聊天会话。

例如，以下命令打开当前目录的聊天并询问“查找并修复所有未定义变量”：

代码 聊天 查找 并 修复 所有 未定义类型 变量

该聊天子命令有以下命令行选项：

• -米，--模式 <模式>: 聊天会话中使用的自定义代理。可用选项：问，编辑，Agent，或自定义代理的标识符。默认为Agent输入：.
• -一个，--添加文件 <路径>将文件添加到聊天会话中作为上下文。
• --最大化最大化聊天会话视图。
• - r，--重用Windows使用聊天会话的最后一个活动Windows。
• -输入：n，--新Windows打开一个空的Windows用于聊天会话。

该聊天子命令还支持从管道输入标准输入通过输入：-在命令的末尾。例如：

python app.py | 代码 聊天 为什么 它 失败 -

高级 CLI 选项

有几种 CLI 选项有助于重现错误和高级设置。

隔离 VS Code 实例

默认情况下，VS Code 实例以以下方式共享环境变量：

• 如果这是第一个 VS Code 实例，环境变量将从父进程继承。
• 如果这不是第一个 VS Code 实例，环境变量将从已运行的 VS Code 实例继承。

这种行为在你需要为不同的项目或构建配置使用不同的环境变量时可能会导致问题。例如，如果你正在处理两个需要不同版本的Node.js或不同路径设置。

要以单独的环境变量运行 VS Code 实例，请使用--用户数据目录为每个实例指定唯一用户数据目录的选项：

# 第一次实例，拥有自己的环境
代码 ~/project1 --用户数据目录 ~/vscode-data-project1

# 在不同环境中进行二审
代码 ~/project2 --用户数据目录 ~/vscode-data-project2

每个实例都有不同的--用户数据目录将保持其自身：

• 环境变量
• 设置和偏好
• 已安装的扩展
• 用户界面状态和布局

创建远程隧道

VS Code 与其他 远程环境 集成，变得更加强大和灵活。我们的目标是提供一个连贯的体验，使您能够从一个统一的 CLI 管理本地和远程机器。

Visual Studio Code远程 - 隧道 扩展允许您通过安全隧道连接到远程机器，例如台式机或虚拟机。隧道安全地将数据从一个网络传输到另一个网络。然后，您可以从任何地方安全地连接到该机器，而无需要求SSH。

我们已经在该功能中构建了代码在远程机器上启动隧道的 CLI。你可以运行：

代码 隧道

在远程机器上创建一个隧道。您可以通过 web 或桌面 VS Code 客户端连接到这台机器。

您可以运行以下命令来查看其他隧道命令代码隧道 - 帮助输入：

由于您可能需要在无法安装 VS Code 桌面版的远程机器上运行 CLI，因此 CLI 也可以在 VS Code 下载页面上单独安装。

有关远程隧道的更多信息，您可以查看远程隧道文档。

使用URL打开VS Code

您还可以使用平台的URL处理机制打开项目和文件。使用以下URL格式：

打开项目

vscode://file/完整 路径 到 项目}/

vscode://file/c:/myProject/

打开文件

vscode://file/完整 路径 到 文件

vscode://file/c:/myProject/package.json

打开文件到行和列

vscode://file/完整 路径 到 文件}：行：列

vscode://file/c:/myProject/package.json:5:10

打开设置编辑器

vscode://设置/setting.name

vscode://设置/编辑器自动换行

您可以在浏览器或文件资源管理器等可以解析和重定向URL的应用程序中使用该URL。例如，在Windows上，您可以传递一个vscode://URL 直接发送到Windows资源管理器或命令行启动 vscode://{文件的完整路径}输入：.

下一步

继续阅读，了解：

• 集成终端 - 在 VS Code 内运行命令行工具。
• 基本编辑 - 了解 VS Code 编辑器的基础知识。
• 代码导航 - VS Code 让你可以快速理解并浏览你的源代码。

常见问题

'code' 未被识别为内部或外部命令

您的操作系统无法找到 VS Code 二进制文件代码在它的路径上。VS Code 的 Windows 和 Linux 安装应该已经将 VS Code 安装到你的路径上。尝试卸载并重新安装 VS Code。如果代码 仍然未找到，查阅平台特定的设置主题 Windows 和 Linux。

在 macOS 上，你需要手动运行 Shell Command: 在 PATH 中安装 'code' 命令 命令（通过 命令面板 ⇧⌘P（Windows, Linux Ctrl+Shift+P）可用）。请参阅 macOS特定设置主题了解详细信息。

如何在 VS Code 内部访问命令行（终端）？

VS Code 有一个集成终端，您可以在其中从 VS Code 内部运行命令行工具。

我可以在 VS Code 中指定设置位置，以便拥有便携版吗？

不是直接通过命令行，但 VS Code 有一个便携模式，这允许您将设置和数据保存在与您的安装相同的位置，例如在 USB 驱动器上。

如何检测 VS Code 启动了一个 shell？

当 VS Code 启动时，它可能会启动一个 shell 以源 "shell 环境" 以帮助设置工具。这将启动一个交互式登录 shell 并获取其环境。根据你的 shell 设置，这可能会导致问题。例如，可能意外的是 shell 以交互式会话启动，VS Code 需要这样做以尝试对齐$PATH在用户创建的终端中使用准确值。

每次 VS Code 启动这个初始 shell 时，VS Code 会设置变量VSCODE_解析环境至1. 如果你的 shell 或用户脚本需要知道它们是否在这个 shell 的上下文中运行，你可以检查VSCODE_解析环境值。