【翻译】在Mac上使用VSCode创建你的第一个Asp.Net Core应用

Setting Up Your Development Environment


To setup your development machine download and install .NET Core and Visual Studio Code with the C# extension. Node.js and npm is also required. If not already installed visit nodejs.org.

首先在你的机器上下载.Net Core和Visual Studio Code和相应的 C#扩展插件。Node.js和npm也是必须的,如果你的机器上没有,可以从Nodejs.org下载安装。

Scaffolding Applications Using Yeoman


We will be using [yo aspnet] to generate the Web Application Basic template, you may follow the full instructions in Building Projects with Yeoman to create an ASP.NET Core project which show an Empty Web for reference.

我们将使用[yo aspnet]去生成Web应用程序的基础模板,你也可以按照Building Projects with Yeoman的步骤创建一个空的Asp.Net Core Web应用程序。

Install the necessary yeoman generators and bower using npm.


npm install -g yo generator-aspnet bower

Run the ASP.NET Core generator

运行Asp.Net Core生成器

yo aspnet


  • Select Web Application Basic [without Membership and Authorization] and tap Enter

  • 选择Web Application Basic [without Membership and Authorization] 然后回车

  • Select Bootstrap (3.3.6) as the UI framework and tap Enter

  • UI framework下选择Bootstrap(3.3.6) 然后回车

  • Use "MyFirstApp" for the app name and tap Enter

  • 使用“MyFirstApp”作为引用的名称,然后回车

When the generator completes scaffolding the files, it will instruct you to restore, build, and run the application.


Your project is now created, you can use the following commands to get going
       cd "MyFirstApp"
       dotnet restore
       dotnet build (optional, build will also happen with it's run)
       dotnet run

Developing ASP.NET Core Applications on a Mac With Visual Studio Code

在Mac上使用Visual Studio Code开发Asp.Net Core应用程序

  • Start Visual Studio Code

  • 打开Visual Studio Code

  • Tap File > Open and navigate to your ASP.NET Core app

  • 点击 File > Open,导航到你的Asp.Net Core应用目录

File menu

When the application is opened, Visual Studio Code will prompt to restore the needed project dependencies as well as add build and debug dependencies.

当应用程序被打开时,Visual Studio Code会提示恢复所需的项目依赖项以及添加构建和调试所需的依赖项。

Info messages: 1. There are unresolved dependencies from project.json. Please execute the restore command to continue. 2. Required assets to build and debug are missing from your project. Add them?

Tap "Yes" to add the build and debug assets.


In the VS Code Explorer sidebar, launch.json and tasks.json files are added to the .vscode folder.

Tap "Restore" to restore the project dependencies. Alternately, you can enter ⌘⇧P in Visual Studio Code and then type dot as shown:

点击“Restore”恢复项目所需依赖项。在开发中,你也可以在Visual Studio Code中按⌘⇧P进行恢复:

Command bar showing autocompletion option on typing 'dot' for 'dotnet: Restore Packages'

You can run commands directly from within Visual Studio Code, including dotnet restore and any tools referenced in the project.json file, as well as custom tasks defined in .vscode/tasks.json. Visual Studio Code also includes an integrated console where you can execute these commands without leaving the editor.

你可以直接在Visual Studio Code中运行包括恢复和使用 project.json中的项目引用,也可以在.vscode/tasks.json中自定义任务。Visual Studio Code还包括集成的控制台,你可以在不离开编辑器的情况下执行这些命令。

If this is your first time using Visual Studio Code (or just Code for short), note that it provides a very streamlined, fast, clean interface for quickly working with files, while still providing tooling to make writing code extremely productive.

如果这是你第一次使用Visual Studio代码(或刚用不久),你会发现它提供了一个非常精简,快速、干净的界面,快速处理文件,同时还提供了很多工具让编写代码非常富有成效。

In the left navigation bar, there are five icons, representing four viewlets:


  • Explore
  • Search
  • Git
  • Debug
  • Extensions

The Explorer viewlet allows you to quickly navigate within the folder system, as well as easily see the files you are currently working with. It displays a badge to indicate whether any files have unsaved changes, and new folders and files can easily be created (without having to open a separate dialog window). You can easily Save All from a menu option that appears on mouse over, as well.


The Search viewlet allows you to quickly search within the folder structure, searching filenames as well as contents.


Code will integrate with Git if it is installed on your system. You can easily initialize a new repository, make commits, and push changes from the Git viewlet.

VSCode已经集成了Git,你的系统如果已经安装好的话,可直接使用。你可以在Git视图里轻松的create repository,commits,和push。


GIT sidebar indicating 'This workspace isn't yet under git source control' with an 'Initialize git repository' button

The Debug viewlet supports interactive debugging of applications.


Code's editor has a ton of great features. You'll notice unused using statements are underlined and can be removed automatically by using ⌘ . when the lightbulb icon appears. Classes and methods also display how many references there are in the project to them. If you're coming from Visual Studio, Code includes many of the same keyboard shortcuts, such as ⌘KC to comment a block of code, and ⌘KU to uncomment.

VSCode编辑器界面也有很多非常棒的功能。当有黄色灯泡小图标时,你会发现没有在没有引用的声明下有下划线,可以使用⌘.自动修复。你的类和方法上会显示它们在项目中有多少次被引用。如果你曾经使用过Visual Studio,你会发现VSCode拥有很多相同的快捷键,比如⌘KC来注释代码,⌘KU来取消注释等等。

More on editor in Visual Studio Code.

更多功能查看Visual Studio Code

Running Locally Using Kestrel


The sample is configured to use Kestrel for the web server. You can see it configured in the project.json file, where it is specified as a dependency.

示范已经使用Kestrel配置好Web Server了。你可以在project.json文件中看到它被配置成依赖项。


Using Visual Studio Code Debugger

使用Visual Studio Code调试

If you choose to have the debug and build assets added to the project:


  • Tap the Debug icon in the View Bar on the left pane

  • 点击左侧面板中的Debug图标

  • Tap the "Play (F5)" icon to launch the app

  • 点击“Play(F5)”图片,运行应用。

DEBUG sidebar showing the triangle play button

Your default browser will automatically launch and navigate to http://localhost:5000


Browser window

  • To stop the application, close the browser and hit the "Stop" icon on the debug bar
  • 关闭浏览器点击调试条上的“Stop”图标,可以停止应用。

VS Code Debug bar

Using the dotnet commands


  • Run dotnet run command to launch the app from terminal/bash

  • 在terminal/bash中运行dotnet命令

  • Navigate to http://localhost:5000

  • 浏览器打开http://localhost:5000

  • To stop the web server enter ⌃+C.

  • ⌃+C停止web服务器

Publishing to Azure


Once you've developed your application, you can easily use the Git integration built into Visual Studio Code to push updates to production, hosted on Microsoft Azure.

在你开发你的应用的时候,你能轻松的使用VSCode集成的Git更新到在Microsoft Azure上的生产环境。

Initialize Git


Initialize Git in the folder you're working in. Tap on the Git viewlet and click the Initialize Git repository button.

在你工作的文件中初始化Git。点击Git视图,再点击Initialize Git repository按钮。

GIT sidebar

Add a commit message and tap enter or tap the checkmark icon to commit the staged files.


GIT sidebar showing file changes

Git is tracking changes, so if you make an update to a file, the Git viewlet will display the files that have changed since your last commit.


Initialize Azure Website

初始化Azure Web站点

You can deploy to Azure Web Apps directly using Git.


Create a Web App in the Azure Portal to host your new application.


Microsoft Azure Portal: New button: Web + Mobile selection in the Marketplace list reveals a Web App button under Featured Apps

Configure the Web App in Azure to support continuous deployment using Git.


Record the Git URL for the Web App from the Azure portal.

从Azure后台记录你的Git Url

Azure Portal for web application: Overview panel

In a Terminal window, add a remote named azure with the Git URL you noted previously.

在终端窗口中,添加一个名为azure提交到之前你记录的Git Url上。

git remote add azure https://shayneboyer@myfirstappmac.scm.azurewebsites.net:443/MyFirstAppMac.git

Push to master. git push azure master to deploy.


Command window showing a successful deployment

Browse to the newly deployed web app.


Browser window

Looking at the Deployment Details in the Azure Portal, you can see the logs and steps each time there is a commit to the branch.


Azure Portal for web application: Deployment Details



posted @ 2017-01-16 10:30  James.Ying  阅读(1126)  评论(0编辑  收藏  举报