Web 版 VS Code - Azure
VS Code for the Web 是 Visual Studio Code 的零安装、基于浏览器的版本。可通过 https://vscode.dev/azure 访问的 /azure (简称) 环境是一个专用于 Azure 开发的空间,让您可以在几秒钟内运行、调试和将应用程序部署到 Azure。
该环境由 Azure Cloud Shell 提供支持,提供高达 4 小时的计算时间,无需手动配置开发环境或安装依赖项。/azure 预装了最新的库、扩展和工具,让您立即开始编码。

入门
/azure 环境包含您开始开发和部署 Azure 应用程序所需的一切
预安装的扩展
Azure Developer CLI - 此扩展使您可以使用 Azure Developer CLI 更轻松地运行、创建 Azure 资源和部署 Azure 应用程序。
支持的编程语言
所有主要运行时均已预安装
- Python - 3.12.9
- Java - openjdk 17.0.16 2025-07-15 LTS
- OpenJDK Runtime Environment Microsoft-11926113 (build 17.0.16+8-LTS)
- OpenJDK 64-Bit Server VM Microsoft-11926113 (build 17.0.16+8-LTS, mixed mode, sharing)
- Node.js - v20.14.0
- C# - 9.0.304
GitHub 仓库
使用 GitHub Repository 扩展,您可以无缝地将更改提交到您的 GitHub 仓库。GitHub Repositories 允许您远程浏览和编辑仓库,而无需将代码拉取到本地机器。您可以在我们的 GitHub Repositories 指南中了解有关该扩展及其工作原理的更多信息。
继续在桌面 VS Code 中工作
在 Azure Cloud Shell 容器时间结束后,您可能希望在桌面 VS Code 中继续您的工作。使用位于 VS Code for the Web 状态栏中的 继续在...上工作 按钮,将您的代码提交到 GitHub 中选择的仓库,然后切换到您的本地环境。
在此体验中,您有两种本地继续使用的选项
- 使用 Docker:启动预配置的开发容器。
- 使用本地 VS Code:克隆仓库并使用 README 文件配置您的环境。
Azure 入口点
/azure 体验与 Microsoft Foundry 集成,以使代码更贴近开发人员。诸如 在 Web 版 VS Code 中打开 之类的按钮直接在 聊天游乐场 和 代理游乐场 以及 Microsoft Foundry 主页 等环境中可用。请参阅示例用例或场景部分了解更多信息。
开始使用
- 选择一个模型。
- 构建并测试您的代理。
- 选择 查看代码,然后选择您的编程语言和 SDK。
- 使用 在 Web 版 VS Code 中打开 按钮以 一键方式启动到 VS Code。
或者,您可以从 Microsoft Foundry 主页创建代理
- 打开 Microsoft Foundry 主页 (https://ai.azure.com)
- 查看主页上生成的建议代码片段
- 选择 在 VS Code 中打开,以获得基于生成的代码创建代理的一键体验
此外,开发人员可以使用 AI 应用库 (https://aka.ms/aiapps) 从模板开始,并选择 在 VS Code 中打开,以在一项操作中将模板启动到 /azure 环境。
开始使用
- 导航到 AI 应用库 (https://aka.ms/aiapps)
- 选择一个模板或搜索您想要运行的模板
- 从下拉菜单中选择 在 VS Code 中打开
- 直接启动到 VS Code 并使用 GitHub Copilot 回答您可能遇到的任何问题。
我们还与 Azure 门户进行了集成。开发人员现在可以在生成代码时从 Azure Copilot 访问“在 VS Code 中打开”按钮。
开始使用
- 打开 Azure 门户 并使用您的 Azure 帐户登录
- 导航到 Azure Copilot 并开始开发您想要构建的场景
- 一旦 Copilot 生成了代码,请选择生成的代码文件,然后选择 在 VS Code 中打开
- 直接启动到 VS Code 并使用 GitHub Copilot 回答进一步的问题。
示例用例或场景
以下是 \azure 环境中常用的场景。
-
- 访问 Microsoft Foundry NextGen 门户,并在为您的代理生成的代码旁边选择 在 VS Code 中打开
- 让 VS Code for the Web - Azure 环境初始化并设置您的环境
- 阅读 README 文件并按照步骤运行 create_and_run_agent.py 文件
- 您的代理已创建并成功运行!继续使用预安装的 Foundry 扩展来微调您的代理,或按照以下步骤使用您的代理创建应用程序
-
使用 Microsoft Foundry 创建模型部署并在 VS Code 中打开您的代码
-
从 Microsoft Foundry 门户中,选择最适合您用例的模型,包括 Foundry Models 中的 o3、o4-mini 或 MAI-DS-R1。在此示例中,我们将使用 gpt-4o-mini 作为代理工作流的示例模型。

-
从 gpt-4o-mini 模型卡片中配置模型终结点。

-
进入代理游乐场,更改生成控制,例如最大响应和过去的消息。添加知识、工具和操作。

-
迭代您的示例提示并继续在代理游乐场中进行实验。
-
满意后,选择 查看代码 按钮,以查看与代理游乐场中代理交互的上下文代码示例。

在那里,您可以查看 Python、C# 和 JavaScript 的多语言代码示例,以及模型包含 JSON、cURL、JavaScript、C# 和 Go,Entra ID 可用于使用现在可用于模型的“密钥授权”对代理进行身份验证。

-
准备就绪后,选择 在 VS Code 中打开 并重定向到 VS Code for the Web 的 /azure 环境。

您会注意到,随着环境的设置,代码示例、API 终结点和密钥会自动导入到新的 VS Code for the Web 工作区。

在右下角,您会看到 API 密钥已设置在终端的环境变量中,并且代码示例已成功下载。

-
通过
python agent_run.py通过终端在本地运行模型。几秒钟内,您将看到成功的模型响应。
-
可以使用
azd命令来配置和部署使用代理的 Web 应用程序。azd init初始化 git 仓库,从而创建默认 Azure 工作区,代理可以在其中用于应用程序。
-
azd up通过创建相关的 Azure 资源来配置 Web 应用程序。完成后,您可以选择终端中提供的链接在浏览器中查看您的应用程序
-
通过选择左下角的“继续到桌面”,在桌面或 GitHub Desktop 上继续。此按钮允许您将工作区以一项操作移动到本地环境。如果您将开发容器附加到现有应用程序,您可以选择使用该容器或移动到本地环境。

-
-
上述快速入门适用于 vscode.dev/azure,因为 vscode.dev/azure 涵盖了所有先决条件
- 已安装 Python
- 已安装 Azure Functions Core Tools
- 您需要自行安装这些
- Azure Functions 扩展
-
主要功能
- 具有丰富的生成式 AI 模型来源的模型目录 (GitHub、ONNX、OpenAI、Anthropic、Google、...)
- 从远程托管模型或正在本地运行的 Ollama 模型导入您自己的模型
- 用于模型推理或通过聊天进行测试的游乐场
- 支持多模态语言模型的附件支持
- 批量运行所选 AI 模型的提示
- 使用支持的流行评估器(如 F1 分数、相关性、相似性、连贯性等)使用数据集评估 AI 模型
限制
虽然 Web 版 VS Code 几乎与桌面版 VS Code 相当,但开发环境存在一些限制
- 无法访问 Cloud Shell 之外的终端
- 对某些本机扩展或语言功能的有限支持
- 不支持离线使用
故障排除
如果您在使用 VS Code for the Web – Azure 时遇到任何问题,请在我们的 GitHub 仓库中提交问题
连接问题
如果您无法连接到 https://vscode.dev/azure,通常可以通过重置您的 Azure Cloud Shell 来解决。这可以从 Azure 门户完成。
使用右上角按钮在 Azure 门户中打开 Cloud Shell。

接下来,在设置下拉菜单中,选择 重置用户设置。

完成后,您应该看到此屏幕。

收集日志
扩展日志将帮助我们诊断 vscode.dev/azure 的任何问题。您可以通过转到输出视图,然后选择 VS Code for the Web - Azure 输出通道来访问它们。


相关资源
继续学习和探索以下资源
反馈与支持
在您使用 vscode.dev/azure 时发现问题时,在我们的 GitHub 仓库中创建问题。细节越多越好。如果可能,请包含来自“VS Code for the Web - Azure”输出通道的日志。