第二章：环境搭建——安装vVIRTUALtarget工具链、配置系统环境变量、验证安装是否成功

好，咱们正式开始动手了。

上一章我们聊了vVIRTUALtarget能干什么，这一章，咱们就把它的“家”给安好。说白了，就是装软件、配路径、跑个demo看看能不能亮。

我个人习惯，在搭建任何验证环境之前，先看一眼官方文档的系统要求。别小看这一步，我见过太多同事上来就装，结果卡在某个依赖库上，一查，系统版本不对，白忙活半天。

2.1 系统要求与准备工作

先确认你的机器够不够格。vVIRTUALtarget对Linux支持最好，Windows也能跑，但性能会打点折扣。

项目 最低配置 推荐配置
操作系统 Ubuntu 18.04 / CentOS 7 Ubuntu 22.04 / RHEL 8
CPU 4核 8核及以上
内存 8 GB 32 GB
磁盘 20 GB 空闲 100 GB SSD
Python版本 3.8 3.10
⚠️ 注意： 如果你用的是Windows，记得提前装好WSL2或者Cygwin。我曾经在Windows上直接跑，结果路径分隔符搞出一堆莫名其妙的错误，后来老老实实切到WSL2才消停。

2.2 下载安装包

去官网或者你公司内部的软件仓库，找到vVIRTUALtarget的安装包。通常是一个 .run 文件或者 .tar.gz 压缩包。

我个人习惯把安装包放在 /opt 目录下，这样所有用户都能访问。当然，你也可以放自己家目录，看你们团队的习惯。

# 假设下载的是 vvirtualtarget-2024.1-linux-x86_64.run
chmod +x vvirtualtarget-2024.1-linux-x86_64.run
sudo ./vvirtualtarget-2024.1-linux-x86_64.run

安装过程中，它会问你安装路径。我建议用默认的 /opt/vVIRTUALtarget，省得后面配环境变量时还要到处找。

💡 小技巧： 安装时如果提示缺少某个库，比如 libssl.so.1.1，别慌。用 apt-get install 或者 yum install 补上就行。我遇到过最坑的一次是缺了 libncurses.so.5，折腾了半小时才发现是32位库没装。

2.3 配置系统环境变量

装完了，但系统还不知道你把它装哪了。你得告诉它。

打开你的 ~/.bashrc 或者 ~/.zshrc，在末尾加上这几行：

# vVIRTUALtarget 环境变量
export VVIRTUAL_HOME=/opt/vVIRTUALtarget
export PATH=$VVIRTUAL_HOME/bin:$PATH
export LD_LIBRARY_PATH=$VVIRTUAL_HOME/lib:$LD_LIBRARY_PATH

然后让配置生效：

source ~/.bashrc

嗯，这里要注意：LD_LIBRARY_PATH 这个变量，有时候会跟系统自带的库冲突。我建议只在当前终端里设，别写到全局的 /etc/profile 里，否则可能影响其他工具。

2.4 验证安装是否成功

环境配好了，怎么知道它能不能用？跑个最简单的命令试试。

vvirtualtarget --version

如果看到类似这样的输出，说明安装成功了：

vVIRTUALtarget version 2024.1 (build 12345)
Copyright (c) 2024 vVIRTUALtarget Inc.

如果提示 command not found，别急。先检查一下 PATH 里有没有包含 $VVIRTUAL_HOME/bin：

echo $PATH

看看输出里有没有 /opt/vVIRTUALtarget/bin。没有的话，回头检查一下 ~/.bashrc 里的路径写对了没。

🔍 深度验证： 光看版本号还不够。我建议再跑一个自带的demo，确保核心功能正常。 
# 进入demo目录
cd $VVIRTUAL_HOME/demo/hello_world

# 运行demo
vvirtualtarget -f hello_world.tcl

如果终端里打印出 Hello, vVIRTUALtarget! 之类的信息，恭喜你，环境完全OK。

2.5 常见问题与避坑指南

  • 权限问题： 安装时如果用 sudo，记得把安装目录的所有权改回你自己，否则后面写日志、生成临时文件时会报错。命令：sudo chown -R $USER:$USER /opt/vVIRTUALtarget
  • Python版本冲突： vVIRTUALtarget内部自带了一个Python解释器，但如果你系统里装了多个Python版本，可能会抢解释器。我建议用 vvirtualtarget --python 来指定用哪个。
  • 防火墙/代理： 如果你在公司内网，安装时可能需要配置代理。设置 http_proxy 和 https_proxy 环境变量就行。
⚠️ 我曾经踩过的坑： 有一次我装完vVIRTUALtarget，跑demo时一直报 libQt5Core.so.5: cannot open shared object file。查了半天，发现是系统里Qt版本太旧。最后用 apt-get install qt5-default 解决了。所以，如果你遇到类似的库缺失问题，先看看是不是系统依赖没装全。

2.6 小结

到这一步，你的vVIRTUALtarget环境就算搭好了。说白了，就是三步：下载、安装、配路径。但别小看这三步，我见过太多人在环境上浪费一整天。

下一章，我们会正式创建一个虚拟目标，然后跑第一个真正的验证用例。到时候你会发现，前面这些准备工作，都是值得的。

💡 最后提醒： 如果你用的是团队共享的服务器，记得把环境变量写到 /etc/profile.d/vvirtualtarget.sh 里，这样所有用户登录时自动生效。别问我怎么知道的——我曾经因为没这么做，被同事追着问了一下午“为什么我跑不了”。
← 上一章 📖 返回目录 下一章 →