V 语言安装完整指南：5 分钟从零开始跑通 Hello World

V 语言安装完整指南：5 分钟从零开始跑通 Hello World

【免费下载链接】vSimple, fast, safe, compiled language for developing maintainable software. Compiles itself in <1s with zero library dependencies. Supports automatic C => V translation. https://vlang.io项目地址: https://gitcode.com/GitHub_Trending/v/v

本文将带你用约 5 分钟完成 V 语言安装，并从零开始跑通第一个 Hello World 程序。全程只需要三条命令。V 语言以快著称——编译器不到一秒就能把自己编译一遍，而且没有空指针、没有全局变量，新手也不容易踩内存的坑；Web 框架、ORM、图形库都是语言自带的，装好编译器就能直接用。

效果预览：你最终会看到什么

先看看终点。V 语言 Hello World 的全部代码，就一行，在仓库自带的 examples/hello_world.v 里：

println('Hello, World!')

编译运行之后，终端里会多出一行输出：

Hello, World!

就这么多。下面按步骤拆解怎么走到这一步。

动手前：30 秒环境检查

装 V 语言之前，先确认电脑上有两样东西：git 和一套 C 编译工具链。V 的构建脚本会自己下载 TinyCC，所以不用额外准备 C 编译器。

• Linux / macOS / WSL：打开终端，输入git --version。如果提示找不到命令，先装上它和编译工具，Ubuntu 和 Debian 执行sudo apt install git build-essential make即可。
• Windows：确认命令行（CMD）里能运行git，并保证用的是 CMD 而不是 PowerShell，后文命令按 CMD 写。

安装实操：3 条命令装好编译器

Linux / macOS / WSL

在终端里依次执行：

git clone --depth=1 https://gitcode.com/GitHub_Trending/v/v cd v make

跑完之后，编译器可执行文件就放在仓库根目录，即[V 仓库路径]/v，后面用./v调用它。

Windows

把make换成仓库提供的 makev.bat，其余一样：

git clone --depth=1 https://gitcode.com/GitHub_Trending/v/v cd v makev.bat

把 v 放进 PATH（推荐做一次）

PATH 就是系统查找命令的路径列表，加进去之后你在任何目录都能直接敲v。用自带的命令做软链接最省事：

• Unix 系统（含 WSL）：sudo ./v symlink，默认在 /usr/local/bin 建一个 v 的链接。
• Windows：用管理员身份打开 CMD，进仓库目录后执行v symlink。

只需做一次。之后你执行v up升级编译器，链接依然有效，不用重复操作。

跑通 Hello World：第一条运行命令

不用自己新建文件，直接运行仓库自带的示例：

./v run examples/hello_world.v

这条命令会先编译再执行。看到终端输出Hello, World!，说明 V 语言安装和编译运行都成功了。

一分钟自检：编译 V 自己 + REPL 试一句

想确认编译器完全正常，可以让它编译自己。整个 V 仓库就是用 V 写的，执行v self会用刚装好的编译器重新编译一遍，不到一秒就完成，这就是它"秒级编译"的直观体现。

再直接输入v进入 REPL——一个交互式窗口，敲一句代码立刻出结果，不用写文件：

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

看到hello world就大功告成了。退出直接敲exit。

上手之后：挑一个方向继续玩

• 做 Web：内置的 veb 框架十几行代码就是一个网站，完整教程见 tutorials/building_a_simple_web_blog_with_veb/。

• 写图形游戏：Tetris、2048、Asteroids 都在仓库里，v run直接就能玩，比如 examples/tetris/tetris.v。
• 玩终端 UI：term.ui 库能写像素级的终端小游戏，参考 examples/term.ui/pong.v。

• 会 C 想迁移：V 支持把 C 代码自动翻译成 V，入门可以看 tutorials/C2V_translating_simple_programs_and_DOOM/。

遇到问题怎么办

症状：make提示找不到命令。说明构建工具没装全。Linux 上执行sudo apt install git build-essential make，macOS 若缺工具链，运行一次xcode-select --install即可。

症状：编译成功了，但敲v提示 command not found。这是没加进 PATH 导致的。按前文执行一次sudo ./v symlink（Windows 用管理员 CMD 执行v symlink），然后重启终端再试。

症状：Windows 下执行make报错或没反应。Windows 不支持直接make，请改用makev.bat；PowerShell 用户则运行./makev.bat。

症状：想升级到最新版编译器。在仓库目录执行v up，一条命令完成更新，之前做的 symlink 不用重做。

最后

从装好到跑通，整条链路就三步：

git clone --depth=1 https://gitcode.com/GitHub_Trending/v/v && cd v && make && ./v run examples/hello_world.v

现在打开 examples/ 目录，挑一个感兴趣的示例跑起来，你的 V 语言从零开始之旅就算真正开始了。

【免费下载链接】vSimple, fast, safe, compiled language for developing maintainable software. Compiles itself in <1s with zero library dependencies. Supports automatic C => V translation. https://vlang.io项目地址: https://gitcode.com/GitHub_Trending/v/v