V 的主要特性

• 简单：可以在一个周末内学会这门语言
• 编译速度快：使用 Clang 后端约 110k 行/秒，使用原生和 tcc 后端约 500k 行/秒 （Intel i5-7500，SSD，无优化） （演示视频）
• 易于开发：V 可以在不到一秒的时间内编译自身
• 性能：与 C 语言一样快（V 的主要后端编译为可读的 C 代码）
• 安全：没有空值，没有全局变量，没有未定义行为（进行中），默认不可变
• C 到 V 的转换（翻译 DOOM 演示视频）
• 热代码重载
• 灵活的内存管理。默认使用 GC，通过 v -gc none 手动管理，通过 v -prealloc 进行竞技场分配，通过 v -autofree 自动释放（自动释放演示视频）。
• 跨平台 UI 库
• 内置图形库
• 轻松跨平台编译
• REPL
• 内置 ORM
• 内置 Web 框架
• C 和 JavaScript 后端
• 非常适合编写底层软件（Vinix 操作系统）

稳定性、未来变化、1.0 版本后的冻结

尽管处于早期开发阶段，V 语言相对稳定，不经常变化。但在 1.0 版本之前仍会有一些变化。 大多数语法变化都可以通过 vfmt 自动处理。

V 核心 API（主要是 os 模块）在稳定到 V 1.0 之前也会有一些小的变化。当然，在此之后 API 会继续增长，但不会破坏现有代码。

1.0 版本发布后，V 将进入"功能冻结"模式。这意味着语言不会有破坏性变化，只有错误修复和性能改进。类似于 Go。

会有 V 2.0 吗？1.0 版本后的十年内不会，也许永远不会。

总之，与许多其他语言不同，V 不会一直变化，不会引入新特性并修改旧特性。它始终会是一门小巧简单的语言，与现在非常相似。

从源代码安装 V

--> （这是首选方法）

Linux、macOS、Windows、*BSD、Solaris、WSL 等

通常，如果您的环境中已经有一个功能正常的 git 安装，安装 V 会非常简单。

注意：在 Windows 上，在 CMD 中运行 make.bat 而不是 make，或在 PowerShell 中运行 ./make.bat。 注意：在 Ubuntu/Debian 上，您可能需要先运行 sudo apt install git build-essential make。

要开始，请在终端/Shell 中执行以下命令：

git clone https://github.com/vlang/v
cd v
make

就这样，您应该在 [V 仓库路径]/v 找到您的 V 可执行文件。 [V 仓库路径] 可以是任何位置。

（如上面的注释所说，在 Windows 上，使用 make.bat 而不是 make。）

现在尝试运行 ./v run examples/hello_world.v（或在 cmd shell 中运行 v run examples/hello_world.v）。

• 遇到问题？请参阅上面的注释，并链接到 安装问题 寻求帮助。

注意：V 正在不断更新。要将 V 更新到最新版本，只需运行：

v up

[!注意] 如果您遇到任何问题，或者您使用的是不同的操作系统或 Linux 发行版，无法立即安装或运行，请查看 安装问题 并搜索您的操作系统和问题。

如果找不到您的问题，请将其添加到现有的讨论中（如果存在针对您的操作系统的讨论），或者如果尚未存在针对您的操作系统的主要讨论，请创建一个新的讨论。

C 编译器

如果您的系统有兼容的版本，Tiny C Compiler (tcc) 将由 make 为您下载，并安装在 V 的 thirdparty 目录下。

这个编译器非常快，但几乎不做任何优化。它最适合开发构建。

对于生产构建（使用 V 的 -prod 选项），建议使用 clang、gcc 或 Microsoft Visual C++。如果您正在进行开发，您很可能已经安装了其中之一。

否则，请按照以下说明操作：

• 在 Linux 和 macOS 上安装 C 编译器

• 在 Windows 上安装 C 编译器

创建符号链接

[!注意] 强烈建议您将 V 添加到 PATH 中。这可以让您不必每次都输入 V 可执行文件的完整路径。 V 提供了一个方便的 v symlink 命令来更轻松地完成此操作。

在 Unix 系统上，它会在 /usr/local/bin/v 创建一个指向您的可执行文件的符号链接。要执行此操作，请运行：

sudo ./v symlink

在 Windows 上，以管理员权限启动一个新的 shell，例如按下 Windows 键，然后输入 cmd.exe，右键单击其菜单项，选择"以管理员身份运行"。在新的管理员 shell 中，cd 到您编译 V 的路径，然后输入：

v symlink

（或在 PowerShell 中输入 ./v symlink）

这将通过将 V 添加到 PATH 中使其在任何地方都可用。请在之后重新启动您的 shell/编辑器，以便它可以获取新的 PATH 变量。

[!注意] 不需要多次运行 v symlink - 即使在 v up、重新启动等之后，v 仍然可用。只有在您决定将 V 仓库文件夹移动到其他位置时，才需要再次运行它。

Void Linux

# xbps-install -Su base-devel
# xbps-install libatomic-devel
$ git clone https://github.com/vlang/v
$ cd v
$ make

Docker

git clone https://github.com/vlang/v
cd v
docker build -t vlang .
docker run --rm -it vlang:latest

git clone https://github.com/vlang/v
cd v
docker build -t vlang_alpine - < Dockerfile.alpine
alias with_alpine='docker run -u 1000:1000 --rm -it -v .:/src -w /src vlang_alpine:latest'

with_alpine v -skip-unused -prod -cc gcc -cflags -static -compress examples/http_server.v
with_alpine v -skip-unused -prod -cc gcc -cflags -static -compress -gc none examples/hello_world.v
ls -la examples/http_server examples/hello_world
file   examples/http_server examples/hello_world
examples/http_server: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), statically linked, no section header
examples/hello_world: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), statically linked, no section header

-rwxr-xr-x 1 root root  16612 May 27 17:07 examples/hello_world
-rwxr-xr-x 1 root root 335308 May 27 17:07 examples/http_server

Termux/Android

在 Termux 上，V 需要预先安装一些包 - 一个可用的 C 编译器，以及 libexecinfo、libgc 和 libgc-static。安装它们后，您可以使用与 Linux/macOS 相同的脚本：

pkg install clang libexecinfo libgc libgc-static make git
git clone https://github.com/vlang/v
cd v
make

编辑器/IDE 插件

要为您的编辑器提供 V 编程语言的 IDE 功能，请查看 v-analyzer。它提供了一个 VS Code 扩展 和其他编辑器的语言服务器功能。

JetBrains IDEs（IntelliJ、CLion、GoLand 等）的插件也为 V 提供了出色的开发体验。您可以在其文档中找到所有功能。

其他插件：

• Vim 插件
• Emacs 插件
• Sublime Text 3 插件
• Atom 插件

测试和运行示例

确保 V 可以编译自身：

$ v self
$ v
V 0.3.x
使用 Ctrl-C 或 `exit` 退出

>>> println('hello world')
hello world
>>>

cd examples
v hello_world.v && ./hello_world    # 或简单地
v run hello_world.v                 # 这会构建程序并立即运行

v run word_counter/word_counter.v word_counter/cinderella.txt
v run news_fetcher.v
v run tetris/tetris.v

为了构建俄罗斯方块或 2048（或任何使用 sokol 或 gg 图形模块的程序），您需要为您的系统安装额外的开发库。

V net.http、net.websocket、v install

net.http 模块、net.websocket 模块和 v install 命令都可能使用 SSL。 V

在 Windows 上，正确安装 OpenSSL 是相当困难的。这里的说明可能会（也可能不会）有所帮助。

V 同步

V 的 sync 模块和通道实现使用了 libatomic。 这个库很可能已经安装在你的系统上，但如果没有，你可以通过以下方式安装：

V UI

https://github.com/vlang/ui

Android 图形应用

使用 V 的 vab 工具，为 Android 构建 V UI 和图形应用可以变得非常简单：

./vab /path/to/v/examples/2048

https://github.com/vlang/vab.

开发 Web 应用

查看构建一个简单的网络博客教程和 Gitly，一个轻量快速的 GitHub/GitLab 替代品：

https://github.com/vlang/gitly

Vinix，用 V 编写的操作系统/内核

V 非常适合编写底层软件，如驱动程序和内核。 Vinix 是一个操作系统/内核，已经可以运行 bash、GCC、V 和 nano。

https://github.com/vlang/vinix

致谢

V 感谢 Fabrice Bellard 在 TCC - Tiny C Compiler 上的原创工作。 请注意，TCC 网站比较旧；当前的 TCC 仓库可以在这里找到。 V 使用了位于 https://github.com/vlang/tccbin/ 的预编译 TCC 二进制文件。

故障排除

请参阅我们 wiki 页面 上的 故障排除 部分。