v - 简洁高效的跨平台编程语言具备安全性和高性能

vlang.io | 文档 | 更新日志 | 速度 | 贡献 & 编译器设计

</div> <div align="center" style="display:grid;place-items:center;">

</div>

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++。如果您正在进行开发，您很可能已经安装了其中之一。

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

创建符号链接

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

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

sudo ./v symlink

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

v symlink

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

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

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

Void Linux

<details><summary>展开 Void Linux 说明</summary>

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

</details>

Docker

<details><summary>展开 Docker 说明</summary>

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

使用 Alpine/musl 的 Docker

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'

编译静态可执行文件，可以复制到运行其他 Linux 发行版的服务器上，无需依赖项：

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

</details>

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 提供了出色的开发体验。您可以在其文档中找到所有功能。

其他插件：

测试和运行示例

确保 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 图形模块的程序），您需要为您的系统安装额外的开发库。

系统	安装方法
基于 Debian/Ubuntu	`sudo apt install libxi-dev libxcursor-dev libgl-dev libasound2-dev`
Fedora/RH/CentOS	`sudo dnf install libXcursor-devel libXi-devel libX11-devel libglvnd-devel`
NixOS	将 `xorg.libX11.dev xorg.libXcursor.dev xorg.libXi.dev libGL.dev` 添加到 `environment.systemPackages` 中

V net.http、net.websocket、`v install`

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

系统	安装命令
macOS	`brew install openssl`
基于 Debian/Ubuntu	`sudo apt install libssl-dev`
Arch/Manjaro	openssl 默认已安装
Fedora/CentOS/RH	`sudo dnf install openssl-devel`

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