# 你好，世界

本文将指引你逐步创建、编译并运行 Vapor 的项目。

如果尚未安装 Swift 和 Vapor Toolbox，请查看安装部分。

- [安装 → macOS](../install/macos.md)
- [安装 → Linux](../install/linux.md)

## 创建

首先，在电脑上创建 Vapor 项目。

打开终端并使用以下 Toolbox 的命令行，这将会在当前目录创建一个包含 Vapor 项目的文件夹。

```sh
vapor new hello -n
```

!!! tip
	使用 `-n` 为所有的问题自动选择 no 来为您提供一个基本的模板。


命令完成后，切换到新创建的文件夹

```sh
cd hello
```

## 编译 & 运行

### Xcode

首先，在Xcode打开项目：

```sh
open Package.swift
```


Xcode 将自动开始下载Swift包管理器依赖，在第一次打开一个项目时，这可能需要一些时间，当依赖下载后，Xcode将显示可以用的 Scheme。

在窗口的顶部，在Play和Stop按钮的右侧，单击项目名称以选择项目的Scheme，并选择一个适当的target——大概率是“My Mac”。单击play按钮编译并运行项目。

你应该会在Xcode窗口的底部看到控制台弹出。

```sh
[ INFO ] Server starting on http://127.0.0.1:8080
```

### Linux

在 Linux 和其他操作系统上(甚至在 macOS 上如果你不想使用 Xcode )，你可以在你喜欢的编辑器中编辑项目，比如 Vim 或 VSCode 。关于设置其他ide的最新细节，请参阅 [Swift Server Guides](https://github.com/swift-server/guides/blob/main/docs/setup-and-ide-alternatives.md)。

在终端运行以下命令来编译和运行你的项目。

```sh
swift run
```
它将构建并运行项目。第一次运行时，需要花费一些时间来获取和下载依赖项。一旦运行，你应该在你的控制台中看到以下内容:

```sh
[ INFO ] Server starting on http://127.0.0.1:8080
```

## Visit Localhost

打开你的浏览器，然后访问 <a href="http://localhost:8080/hello" target="_blank">localhost:8080/hello</a> 或者 <a href="http://127.0.0.1:8080" target="_blank">http://127.0.0.1:8080</a>

你将看见以下页面

```html
Hello, world!
```

恭喜你创建，构建，运行了你的第一个 Vapor 应用！🎉