V编译器命令行使用

编译器命令行

V编译器命令行大小就2M多,实在是小巧得很

执行v help就可以查看到下面的命令行使用说明

Usage:v [options] [command] [arguments]

  • 直接执行V,不带任何参数时,直接进入交互模式
  • 编译某个指定的.v源代码文件,会生成同名的可执行文件,也可以使用-o选项,生成特定的可执行文件名
  • 编译某一个指定的目录,编译器会编译目录中所有*.v的源代码,生成一个单一的可执行文件或库文件,文件名跟目录同名
  • 所有以 test.v结束的文件,会被编译器当做测试文件,编译器执行测试文件时,会按顺序执行所有的以test开头的测试函数
  • 可以把常用的编译选项维护到 VFLAGS 的系统环境变量中,运行编译器时,会合并VFLAGS中的选项,这样就不用每次都重复输入相同的选项
  1. Usage:v [options] [command] [arguments]
  3. 新建项目子命令:
  4.    new               创建新的V项目,主要是生成v.mod项目文件
  5.    init              对现有已存在的V项目生成v.mod项目文件
  7. 标准开发子命令:
  8.    run               编译并运行指定的V源文件或目录
  9.    test              运行指定目录的测试文件
  10.    fmt               格式化代码
  11.    vet                             分析代码存在的错误
  12.    doc               生成指定模块的文档
  13.    repl              运行交互式模式
  14.    watch                          编译项目,并监控源文件修改,保存后自动重新编译
  15.    ast                             将V源代码生成json格式的AST语法树,直观展现V的语法树
  16.    vlib-docs                  调用v doc生成vlib标准库的文档    
  18. 安装和升级子命令:
  19.    symlink           unix系统在/usr/local/bin/v生成链接,windows生成环境变量
  21.    up                升级编译器V到最新版本,等同于git pull,然后make
  22.    self [-prod]      让V编译器自己编译自己(不执行git pull,不使用make),
  23.                                         可使用-prod优化编译
  24.    version           查看编译器版本
  26. 包管理子命令:
  27.    install           从https://vpm.vlang.io/安装指定的一个或多个模块
  28.    remove            删除已安装的模块
  29.    search            搜索模块
  30.    update            升级指定已安装的模块
  31.    upgrade                     升级所有已安装的模块
  32.    list                             列出所有已安装的模块
  33.    outdated                     列出所有过时需要升级的模块
  34.    show                          显示模块的详细信息
  36. 其他子命令:
  37.    translate         把C源代码翻译成V源代码[开发中,估计0.3版本才可以使用]
  38.    doctor                         输出当前电脑的基本环境信息,用于提单到github时,报告环境信息
  39.    tracev                         生成一个带跟踪调试信息的V编译器

可以使用v help xxx进一步查看各个子命令的具体帮助文本:

  1. v help build //显示编译通用选项
  2. v help build-c //显示编译器后端为c(默认)时的编译选项

可查看build和run的子命令详细内容,此部分较为重要,同时build和run子命令的编译选项是共用的

  1. v -b或-backend c ./main.v //指定编译器后端类型:默认是c,也可以是js,x64
  2. v -b js ./main.v     //指定编译器后端类型为js,目前还是试验性质的,不完善
  3. v -b x64 ./main.v     //指定编译器后端类型为x64,目前还是试验性质的,不完善
  5. v -o或-output main.c ./main.v //编译生成C源文件,而不是可执行文件
  7. v -prod xxx.v //生产优化模式编译,生成更小的可执行文件
  9. v -skip-unused xxx.v //V代码编译生成C代码时,忽略未使用的C函数,可以进一步缩小可执行文件大小
  10. v -skip-unused -prod xxx.v //V代码编译生成C代码时,忽略未使用的C函数,并且进行生产编译,可以进一步缩小可执行文件大小
  11. v -skip-unused -o xxx.c xxx.v //生成最小的C文件,忽略未使用的C函数
  13. v -usecache xxx.v  //使用标准库的缓存,而不是每次都重新编译标准库,编译速度快很多
  14. v -usecache -prod xxx.v //使用标准库缓存,生产优化编译,速度也会快很多
  15. v -nocache -prod xxx.v  //取消标准库的缓存,全部重新编译
  16. v -wipe-cache xxx.v //取消标准库的缓存,全部重新编译
  18. v -autofree xxx.v //以自动释放内容方式生成可执行文件
  19. v -obf或-obfuscate //混淆编译生成可执行文件
  20. v -stats //编译时显示额外的统计信息,编译多少行,多少字节,编译时间,每秒编译行数
  21. v -show-timings xxx.v //显示每个编译阶段花费多少时间:扫描,解析,检查,生成C,编译C
  22. v -cg run xxx.v //如果编译报错,-cg选项可以提示报错更多的信息,以及报错对应的C代码行,可以更快地定位错误
  23. v -compress //调用upx，压缩加壳生成二进制文件
  24. v -os <os> //跨平台交叉编译,编译生成指定os的可执行文件,OS可以是:linux, mac, windows, msvc
  25. v -arch x64 //指定编译的架构,可以是x86或x64,默认是x64
  26. v -live   //启用代码热更新编译(只对注解为[live]的函数生效,修改函数内容会实时编译)
  27. v -shared  //编译生成共享库
  28. ...

常用命令例子

  1. v main.v             //编译当前目录中的main.v源文件,生成同名的main可执行文件
  2. v run main.v  //编译并运行当前目录中的main.v源文件
  3. v watch main.v //编译并运行当前目录中的main.v源文件,并监控,保存自动重新运行
  5. v -usecache main.v //使用标准库缓存进行编译
  6. v run main.v     //编译当前目录中的main.v源文件,生成同名的main可执行文件，并运行
  7. v -autofree run main.v //以自动释放内容方式,编译,并运行
  9. v -o myexe main.v     //编译当前目录中的main.v源文件，生成的可执行文件名为myexe
  10. v -o myexe.c mani.v //编译当前目录中的main.v源文件，生成对应的C源文件，而不是可执行文件
  11. v -o myexe.js main.v //编译当前目录中的main.v源文件，生成对应的js源文件，而不是可执行文件
  13. v -prod main.v //生产模式编译当前目录中的main.v源文件，生成更小的可执行文件
  15. v help //查看编译器帮助文本
  16. v help build //查看build子命令的帮助文本
  18. v version //查看编译器版本
  19. v --version //查看编译器版本
  21. v    //进入交互模式
  22. v -  //进入交互模式
  24. v build mymodule //编译mymodule模块（当前位置要在mymodule的上级目录）
  25. v . //编译当前目录
  27. v up //升级V编译器到最新版本,等价于git pull && make
  29. v install xxx模块 //从https://vpm.vlang.io/安装指定的模块
  31. v fmt -w main.v //统一格式化指定源文件或目录中的代码
  33. v ast main.v //将V源代码生成json格式的AST语法树,生成main.json
  34. v ast -w main.v //生成main.json,并且监控源文件变化,保存后自动重新生成
  35. v ast -c main.v //将V源代码同时生成AST语法树文件main.json和C源代码main.c,并且监控源文件变化,保存后自动重新生成
  37. v vet ./main.v //分析main.v源文件代码中存在的错误
  38. v vet .            //分析当前目录中所有V源文件代码中存在的错误
  40. v test mymodule //执行mymodule中的测试文件
  42. v test-compiler  //执行v源代码中所有的测试文件,用于测试编译器本身
  44. v vlib/v/compiler_errors_test.v //执行编译器错误测试,checker/tests,parser/tests
  45. VTEST_ONLY=xxx v vlib/v/compiler_errors_test.v //执行编译器错误测试,并且名字包含xxx
  47. v doctor //输出当前电脑的基本环境信息,主要跟V编译相关,用于提单到github时,报告环境信息,方便排查

相关环境变量

VEXE

VEXE环境变量用于指定V源代码的根目录,一般来说V命令行也在这个目录中.

除非有特殊场景,一般不建议人为指定.

V命令行启动的时候,会检查是否人为指定了该环境变量,如果指定了,就直接使用该环境变量.

如果没有指定,则将VEXE环境变量设置为V命令行所在的目录,

如果fork了V编译器源代码,要修改V编译器源代码,那么最好不要人为设置这个环境变量,让V命令行自动设置该环境变量.

VMODULES

VMODULES环境变量用于指定存放第三方包的目录,所有通过v install下载的第三方包都会统一下载到该目录中,如果没有设置该环境变量,默认存放在~/.vmodules中.

VFLAGS

用于设置V编译器默认使用的flags字符串.

CFLAGS

用于设置调用C编译器要使用的c flag字符串.

LDFLAGS

用于设置调用C编译器要使用的ldflags字符串.

VTMP

用于设置V的临时目录,如果没有设置,则使用操作系统临时目录下的v目录作为V的临时目录.

VCACHE

用于设置V的缓存目录,如果没有设置,则使用操作系统临时目录下的vcache_folder作为缓存目录.

VWATCH_TIMEOUT

用于设置v watch子命令即使文件没有发生变化,也自动重启程序的时间,以秒为单位.如果没有设置该环境变量,v watch默认是300秒自动重启程序.

VCOLORS

用于设置V的终端是否显示彩色字体,可选值为:always,never.

VERBOSE

用于设置编译器是否为详细输出模式,可选值为:1/0.

VCHILD

待定未尝试.

VDIFF_TOOL

v fmt中,如果指定了该环境变量,v fmt -diff不再使用系统默认的比较工具diff,而是使用指定的比较工具.

VDIFF_OPTIONS

v fmt中,传递给VDIFF_TOOL比较工具的选项.