Ubuntu虚拟机配置实战：从安装到开发环境的踩坑指南

在折腾过几年 Ubuntu 虚拟机之后我发现自己踩过的坑基本都能绕地球一圈了。从最早照着教程装完系统就卡在登录界面到后来配个环境变量把整个系统搞到进不去桌面再到被中文输入法折腾到怀疑人生——这些经历让我发现网上关于 Ubuntu 虚拟机的教程虽然多但大多只告诉你怎么点下一步从来不讲为什么这么做、遇到问题怎么办。这篇文章我打算换个思路不写那种下一步下一步的流水账而是把我在实际配置 Ubuntu 虚拟机过程中反复踩过的坑、验证过的方案、排查过的诡异问题都整理出来。每个操作我都尽量讲清楚背后的原因每个坑我都说明白当时是怎么发现的、怎么解决的。希望能让正在折腾的朋友少走点弯路。1. 装之前先想清楚虚拟机方案与版本选型1.1 为什么选虚拟机而不是双系统或 WSL很多人第一次接触 Linux 都会纠结一个问题到底是装双系统还是用虚拟机我个人的建议是除非你有明确的性能需求或者要做硬件相关的底层开发否则虚拟机永远是第一选择。原因很简单虚拟机的本质是一个运行在宿主系统里的独立环境它跟你的 Windows 系统之间有一层隔离。这意味着你可以在里面随便折腾装坏了直接删掉重来完全不影响宿主机。而双系统虽然性能更好但每次切换都要重启分区折腾起来风险也大稍不注意就把原来的系统搞崩了。对于学习、开发、测试这些场景虚拟机的灵活性和安全性优势太明显了。至于 WSLWindows Subsystem for Linux它确实轻量、启动快适合做命令行操作和轻量开发。但如果你是奔着完整学习 Linux 环境去的或者需要在里面跑带图形界面的应用、做网络实验那 WSL 跟完整虚拟机还是有差距的。我之前在 WSL 里跑过一些需要 GUI 的程序折腾半天最终还是回到了虚拟机。1.2 VMware Workstation 和 VirtualBox 怎么选虚拟机软件方面市面上主流就两个VMware Workstation 和 Oracle VirtualBox。这俩我都用过很长时间说说我的真实体验。VMware Workstation 在性能和稳定性上确实更胜一筹尤其是图形加速、USB 设备透传、快照管理这些方面做得都很成熟。它的快照功能特别适合做实验——比如你要在这个环境里装一个可能搞坏系统的软件先打个快照出问题了一秒恢复。缺点是商业软件不过在个人学习场景下有免费版本去官网注册个账号就能拿到密钥。VirtualBox 是开源的完全免费功能上其实也够用。但我在实际使用中遇到过几次 USB 设备识别不稳定的情况而且它的图形性能明显不如 VMware。如果只是装个 Ubuntu 学习基本命令和开发环境VirtualBox 完全没问题如果你要在虚拟机里跑 IDE、看视频、做演示还是优先选 VMware。1.3 Ubuntu 版本选择22.04 LTS 还是 24.04 LTSUbuntu 的版本号分两种普通版本和 LTSLong Term Support长期支持版本。LTS 版本每两年发布一次官方提供长达 5 年的安全更新和维护这是普通版本不具备的。目前最稳妥的选择是 22.04 LTS。为什么不追新因为我踩过坑。我之前用过一段时间的 20.04后来系统提示升级到 22.04升级过程中因为显卡驱动冲突导致系统直接无法启动最后只能重装。所以我的经验是如果是生产环境或者学习环境永远选 LTS 版本并且不要急着升级到刚发布的新版本。新版本刚出来的时候很多软件源、驱动、工具链可能还没有完全适配折腾起来非常心累。ISO 镜像要去 Ubuntu 官网下载不要随便去第三方网站下那些镜像有可能被人动过手脚装完系统发现问题才知道后悔。下载的时候选择桌面版Desktop就好服务器版是给没有图形界面的场景用的除非你确定只需要命令行否则不要选。2. 虚拟机安装与 Ubuntu 系统安装实操2.1 虚拟机创建过程中的关键选项创建虚拟机的时候有几个关键选项容易踩坑我一个个说。首先是客户机操作系统选择一定要选 Linux版本选 Ubuntu 64 位。这里有个新手常犯的错误明明下载的是 64 位镜像结果创建虚拟机的时候选了 32 位。虽然也能装但性能会大打折扣而且很多软件装不上。然后是硬件配置。内存我建议至少给 4GB如果你宿主机内存充足给 8GB 更舒服。处理器分配 2 核以上。磁盘空间方面虽然 Ubuntu 系统本身安装完只占几个 GB但你要装开发环境、软件包、下载依赖空间很快就会膨胀。我建议虚拟机磁盘大小设置 50GB 以上。这里有一个细节VMware 默认是动态分配磁盘就是说它不会立刻占满 50GB而是用到多少占多少所以不用担心空间浪费。网络模式就用默认的 NAT 就好。NAT 模式下虚拟机通过宿主机上网对外表现为宿主机在访问网络这时候虚拟机自己没法被局域网内其他设备直接访问。如果你以后需要让局域网里的设备直接访问虚拟机里的服务比如跑个 Web 服务给同事访问再把网络模式改成桥接模式到时候虚拟机就会像一台独立设备一样出现在局域网里。2.2 安装过程中的交互细节和常见选择安装 Ubuntu 时建议在安装类型这里选择清除整个磁盘并安装 Ubuntu。别怕这里清除的是虚拟机的虚拟磁盘不是你的宿主机磁盘。这一步经常有人搞混以为会把自己电脑的 C 盘清了实际上完全不会。分区方面新手直接选使用整个磁盘就行Ubuntu 会自动划分好系统分区和交换分区。除非你清楚知道自己在做什么否则不建议手动分区——我见过太多人手动分区时把 / 分区空间给太少了装完没跑几天就磁盘爆满。设置用户名密码的时候注意密码别设太复杂因为 Ubuntu 里很多操作用到 sudo 权限都需要输入密码太复杂的密码在虚拟机上输起来很痛苦。但也不要太简单毕竟你的虚拟机会通过 NAT 暴露在网络上。安装过程大概要 5-15 分钟取决于你的磁盘性能和分配的 CPU 核数。装完提示重启的时候记得在虚拟机设置里把光驱CD/DVD里的 ISO 镜像移除不然又会重新进入安装界面。这个坑我见过不少新手踩。2.3 安装后必做的三个优化项系统装好之后第一件事不是急着配环境而是先做三件优化。第一安装 VMware Tools如果你用的是 VMware。通过虚拟机菜单栏的安装 VMware Tools选项系统里会挂载一个虚拟光驱里面是压缩包。解压后运行安装脚本重启后就能获得自适应屏幕分辨率、更好的图形性能、剪贴板共享这些功能。不装的话虚拟机窗口不能自适应缩放宿主机跟虚拟机之间复制粘贴也不方便很难受。第二检查是否需要安装增强功能如果你用的是 VirtualBox叫安装增强功能作用和 VMware Tools 类似。第三配置软件源。Ubuntu 默认的软件源在国外服务器上国内访问速度很慢。需要把源改为国内源比如阿里云、华为云、清华源等。具体操作后面我会讲。3. 基础配置软件源、中文输入法与系统更新3.1 软件源替换从官方源切换到国内镜像软件源是 Ubuntu 下载安装软件的来源地址。默认配置的是官方源在国内访问能慢到让你怀疑人生。你装个软件下载速度几 KB/s 的情况我都遇到过。换成国内源之后速度直接起飞。操作方式看你的 Ubuntu 版本22.04 及以上的版本改这个文件sudo sed -i s/archive.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list这条命令的作用是把软件源列表里所有官方地址替换成阿里云镜像地址。替换完之后执行sudo apt update它会刷新软件包列表这时候源已经更新为国内源了。有一点要提醒如果你用的是 24.04 及更新的版本软件源配置可能已经改到了 /etc/apt/sources.list.d/ubuntu.sources 文件不要去动 sources.list那是旧的路径。修改方式类似用文本编辑器打开那个文件把里面的 URL 替换成镜像地址就行。3.2 中文输入法与字体配置装完 Ubuntu 默认只有英文输入法对于中文用户来说这就是第一个重大问题。我当年第一次装完 Ubuntu 折腾了一个多小时没搞定输入法后来才发现弄错了两件事一是没有安装中文语言包二是没有在输入法框架里正确添加拼音输入源。标准操作是打开设置Settings进入系统或者Region Language地区和语言点击管理已安装的语言Manage Installed Languages如果提示语言支持未完全安装点安装把中文语言包装上。然后回到设置里添加汉语输入源选拼音输入就能用中文了。如果你用的是 Ubuntu 22.04 和 GNOME 桌面它的输入法框架是 IBus自带的中文拼音输入法其实已经挺好用了。但如果你在部分应用里发现中文输入法调不出来可以尝试切换到 Fcitx5sudo apt install fcitx5 fcitx5-chinese-addons然后在设置里把输入法框架改成 Fcitx5登录出再登录入生效。字体方面如果中文显示发虚或者缺字可以安装常见中文字体sudo apt install fonts-noto-cjk这个是 Google 的开源中日韩字体包装完之后中文渲染会舒服很多。3.3 系统更新策略不要盲目升级系统的更新分为两类安全更新和版本升级。安全更新升级补丁一定要装它能修复系统漏洞。版本升级比如从 22.04 升级到 24.04要谨慎除非你有明确需求否则不要主动升级。Ubuntu 有个特性装了某个版本之后如果不想被提醒升级大版本可以在软件与更新的设置里把升级通知改成从不。因为系统大版本升级是一件容易出错的事情尤其是在虚拟机里各种驱动、内核、第三方软件源都有可能在升级后失效。我在 20.04 升级 22.04 时翻过车后来就学乖了新版本用着稳定就行没必要追求最新。4. 开发环境配置JDK、Node.js、Git、MySQL、Docker4.1 JDK 与环境变量配置的完整流程开发学习绕不开 Java我这里说下 JDK 的安装和配置。在 Ubuntu 上装 JDK 最推荐用 apt 包管理器虽然默认源里的 JDK 版本可能不是最新但胜在稳定、配置简单、卸载干净。sudo apt update sudo apt install openjdk-11-jdk如果官方源里没有你需要的版本可以先去 Oracle 官网下载 tar.gz 包手动解压安装。不过对于初学者来说apt 安装的方式已经足够。装完之后验证java -version javac -version这两条命令分别查看运行时环境和编译器的版本如果都正常输出版本号说明 JDK 安装成功。环境变量配置是很多人容易出错的地方。我需要说明一下用 apt 安装的 JDK 其实不需要手动配置 JAVA_HOME因为系统已经把 Java 的可执行文件放进了 /usr/bin 目录命令可以直接找到。但如果你需要配置 JAVA_HOME比如要给某些构建工具用就需要修改环境变量配置文件。/etc/environment 是系统级的环境变量配置修改它需要 sudo 权限适合配置 JAVA_HOME~/.bashrc 是当前用户的环境变量配置适合配置用户级变量。以配置 JAVA_HOME 为例先在终端里找到 JDK 的安装路径update-alternatives --list java这个命令会列出系统里所有的 Java 版本及路径比如 /usr/lib/jvm/java-11-openjdk-amd64/bin/java。然后编辑 /etc/environmentsudo nano /etc/environment加上这一行JAVA_HOME/usr/lib/jvm/java-11-openjdk-amd64保存退出后执行source /etc/environment注意修改环境变量后已经打开的终端窗口不会自动加载新配置要么重新打开终端要么手动执行 source 命令。还有就是环境变量路径一定要写对我见过有人写错路径之后命令找不到导致整个命令行环境崩溃最后只能去改配置文件恢复。4.2 Node.js 安装apt、源码编译与 nvm 的取舍Node.js 的安装方式有三种apt 直接装、官网下载源码编译、用 nvmNode Version Manager管理。我强烈推荐第三种理由后面说。用 apt 安装 Node.js 是最简单的方式但问题在于Ubuntu 官方源里带的是旧版本 Node.js跟很多新项目不兼容。你装完跑一个新项目它可能要求 Node 18 以上而你装的是 Node 12就非常被动。官网源码编译安装的问题也一样虽然可以指定版本但升级麻烦。所以我建议用 nvm。nvm 本身是一个 shell 脚本用来管理多个 Node.js 版本可以随时切换默认版本不同项目用不同版本非常方便。安装方式curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash装完后需要重新打开终端或者执行 source 命令让 nvm 生效。然后nvm install 20 nvm use 20这两条命令分别安装和切换到 Node.js 20。切换后验证一下node -v npm -v这里要提醒一下npm 的默认源在国外国内下载依赖会非常慢而且经常超时。建议直接替换为淘宝镜像源npm config set registry https://registry.npmmirror.com这个操作我建议所有国内开发者都做能省下大量时间。后面的 npm install 速度会有质的提升。4.3 Git 安装与 SSH 配置Git 是程序员必备工具在 Ubuntu 上安装很简单sudo apt install git验证git --version装完之后要做两件事配置用户信息以及配置 SSH 密钥。配置用户信息是必要的不然 Git 提交代码时不知道你是谁git config --global user.name 你的名字 git config --global user.email 你的邮箱生成 SSH 密钥ssh-keygen -t ed25519 -C 你的邮箱一路回车如果想设置密码就输入一个生成的公钥在 ~/.ssh/id_ed25519.pub 文件里。用 cat 命令查看内容然后去 GitHub、Gitee 或者你的代码托管平台添加这个公钥。添加完之后把远程仓库地址用 SSH 方式克隆下来就能免密码推送代码了。这里我说个常见的坑如果克隆时遇到 Permission denied (publickey)大概率就是公钥没有添加成功或者添加之后 SSH 客户端没有读到。可以先试一下ssh -T gitgithub.com如果输出 Hi 你的用户名! Youve successfully authenticated说明 SSH 配置成功。4.4 MySQL 的安装、初始化与远程连接配置MySQL 的安装也有两个方案apt 直接安装官方稳定版或者用 Docker 跑容器。对于初学或者日常开发我用得最多的还是 apt 方式。sudo apt install mysql-server装完后 MySQL 服务会默认启动。查看服务状态sudo systemctl status mysql在 Ubuntu 上MySQL 安装完成后默认的 root 用户是用 auth_socket 插件认证的就是说你只能用系统 root 用户通过 sudo 命令进入 MySQL而不能用密码登录。如果你希望 root 用户能用密码登录需要修改认证插件sudo mysql进入 MySQL 后执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码; FLUSH PRIVILEGES;这样 root 就只能用密码登录了。如果你需要创建一个专门的开发用户并允许远程连接执行CREATE USER dev% IDENTIFIED BY 密码; GRANT ALL PRIVILEGES ON *.* TO dev%; FLUSH PRIVILEGES;这里的 % 表示允许从任何 IP 连接适合开发环境生产环境千万不要这样配置要用具体的 IP。还要改一个配置让远程能连上编辑 /etc/mysql/mysql.conf.d/mysqld.cnf找到 bind-address 这一行把 127.0.0.1 改成 0.0.0.0然后重启 MySQLsudo systemctl restart mysql修改后你就能通过宿主机上的数据库客户端连接虚拟机的 MySQL 了。这里有个注意点如果你用的是 NAT 网络模式宿主机要访问虚拟机里的 MySQL需要用虚拟机 IP 加上端口 3306 来连接。别问我怎么知道的我当初试了半天连不上最后发现是防火墙没放行 3306 端口用 sudo ufw allow 3306 放行后就行了。4.5 Docker 的安装与用户组管理Docker 是现在开发环境里绕不开的工具。Ubuntu 上用官方仓库安装 Docker 是最靠谱的方式sudo apt update sudo apt install docker.io sudo systemctl enable docker sudo systemctl start dockerUbuntu 的官方源里有 docker.io 包安装很方便。但如果你想装最新版的 Docker Engine需要添加 Docker 官方仓库然后从仓库安装。这两种方式的区别在于版本新旧官方仓库的版本更新更及时。对于大多数学习场景直接用官方源里的 docker.io 就够了。装完 Docker如果不对用户组做处理你会发现运行 docker 相关命令都要加 sudo。这是因为 Docker 的守护进程以 root 权限运行普通用户没有权限与它通信。解决办法sudo usermod -aG docker $USER执行完后需要注销登录或者重启虚拟机让用户组生效。之后再运行 docker ps 这类命令就不用加 sudo 了。这里我必须提醒一句Docker 用户组等价于 root 权限。你加入了 Docker 用户组之后就等于拥有了 root 权限因为 Docker 容器能访问宿主机上的任何资源。所以在虚拟机这种测试环境里这么配置可以生产环境要严格限制 Docker 用户组的成员。Docker 拉取镜像同样受网络影响。如果发现 pull 镜像特别慢可以给 Docker 配置加速器。国内各大云厂商都提供了镜像加速地址步骤是在 /etc/docker/daemon.json 里配置 registry-mirrors然后重启 Docker。具体内容根据你使用的云服务商而定。5. 常见问题与排查技巧实录5.1 虚拟机 Ubuntu 黑屏、无法进入桌面这个问题的出现概率非常高我把最常见的几个原因按出现频率排个序。第一个原因显卡驱动问题。安装完 VMware Tools 或者升级内核后显卡驱动可能不匹配导致图形界面起不来。解决方法是开机后按 Ctrl Alt F2 切换到命令行终端输入账号密码登录然后重新安装或者重配驱动。如果用的是 VMware重新运行一下 vmhgfs 相关模块的安装脚本或者直接重新安装 VMware Tools大概率能解决。第二个原因磁盘空间满了。这个情况也很常见Ubuntu 系统盘默认只分配 20GB跑几个 Docker 镜像、编译几个项目就满了。如果发现桌面进不去先切到命令行终端用 df -h 看看磁盘使用率如果满了清理文件或者扩展虚拟磁盘。第三个原因虚拟机内存分配不足。内存不够会导致图形界面崩溃或者无法启动。把虚拟机关机在虚拟机设置里把内存调大。5.2 虚拟机无法联网或网络不通NAT 模式下无法联网先重启虚拟机的网络服务sudo systemctl restart systemd-networkd sudo systemctl restart NetworkManager如果还不行检查 DHCP 服务sudo dhclient -r这条命令能释放掉当前的 DHCP 地址然后重新获取一个有时候就是 IP 分配出了问题。还有一种常见情况虚拟机里能 ping 通局域网 IP但 ping 不通域名。这说明 DNS 解析有问题检查 /etc/resolv.conf 文件看看 nameserver 配置是否正确。实在不行就直接加上公网 DNSsudo nano /etc/resolv.conf加上nameserver 223.5.5.5和nameserver 8.8.8.8。5.3 VMware 提示无法连接虚拟机VMware Workstation 无法连接到虚拟机。请确保您有权运行该程序、访问该程序使用是我被问过无数次的问题。这个问题的本质是 VMware 的服务没有工作或者权限不对。解决办法检查以管理员身份重新启动 VMware Workstation或者重启 VMware 的宿主服务。Windows 服务管理器里找到 VMware 相关的服务确保它们都在运行。如果上述操作无效运行 PowerShell管理员执行net start vmms net start vmnetdhcp net start vmnat这三个服务对应虚拟机的核心功能如果启动失败说明 VMware 安装有问题重装一次就好了。5.4 忘记 Ubuntu 登录密码怎么办这个问题我帮不少人解决过。虚拟机里忘记密码最简单的办法是重启虚拟机在 GRUB 引导界面按 Shift 键或者在虚拟机的 BIOS 里按 Esc进入 GRUB 菜单选择Advanced options for Ubuntu然后进入恢复模式recovery mode选择root - Drop to root shell prompt。进入 root shell 之后执行mount -o remount,rw /这个命令重新以读写方式挂载根目录因为恢复模式下文件系统是只读的。然后直接改密码passwd 你的用户名输入两次新密码重启即可。这个方法在 VMware 和 VirtualBox 里都能用是我验证过很多次的可行方案。5.5 宿主机文件无法复制到虚拟机如果你装了 VMware Tools 或 VirtualBox 增强功能还是不能复制文件大概率是剪贴板共享功能没打开。在虚拟机的菜单栏里找到虚拟机 - 设置 - 选项 - 客户机隔离把启用复制粘贴和启用拖放两个选项都勾上。如果在能复制的情况下经常断或者复制文件后提示权限不足检查一下虚拟机用户目录的写权限通常 chmod 755 ~ 或者 chmod 777 ~ 能解决。另外拖拽文件时要注意目标目录的写权限比如 /usr 目录默认只有 root 能写你把文件拖进去就会提示权限不足。我一般是拖到用户的主目录再用命令移动到需要的位置。5.6 环境变量配错导致系统崩溃这是最吓人也最容易让人崩溃的一个坑。如果你在 /etc/environment 或者 /etc/profile 里写了错误的 PATH会导致几乎所有命令都找不到了。之前我配 PATH 时多加了个错误路径结果终端里 ls、cp 这些基础命令全部失效当时差点以为系统被我搞坏了。遇到这种情况先别慌用绝对路径调用命令/usr/bin/nano /etc/environment因为即使 PATH 错乱/usr/bin/nano 这个绝对路径还是能直接调用程序的。然后修复配置重新加载。如果实在改不回来就重启进入恢复模式用 5.4 节的方法进入 root shell 修改配置文件或者直接删掉配置文件的错误行。教训是改环境变量之前一定要先备份原文件改完之后先用 echo $PATH 检查生效结果确认无误再新增其他操作。我后来配环境变量都养成了先备份的习惯反正就是一条 cp 命令的事花一秒钟换来的是不会被自己坑死。5.7 中文输入法无法切换这个问题的根源往往是 IBus 和 Fcitx5 两套输入法框架冲突。安装 Fcitx5 但没有把系统默认输入法框架切换过去就会出现在某些应用里打字没反应。解决方式是装 FCitx5 相关的环境变量设置包sudo apt install im-config im-config -n fcitx5然后注销再登录。另一个常见原因是 GTK 程序里输入法模块没加载检查终端里有没有设置 QT_IM_MODULE 和 GTK_IM_MODULEexport QT_IM_MODULEfcitx export GTK_IM_MODULEfcitx export XMODIFIERSimfcitx放到 ~/.bashrc 文件里重启后生效。5.8 常见报错信息速查表下面是几个高频报错和对应的解决方案我整理成表格方便对照。报错或现象根本原因解决方案Command xxx not foundPATH 未配置或软件未安装检查 PATH用 dpkg -L 找到二进制位置Package xxx is not available软件源未包含该包更新源或添加对应 PPAPermission denied (publickey)SSH 公钥未添加检查 ~/.ssh/id_*.pub 是否已添加到托管平台E: Unable to locate package源列表未更新sudo apt updatedpkg: error processing package xxx包管理系统损坏sudo dpkg --configure -a虚拟机屏幕显示不全VMware Tools 未安装安装或重装 VMware ToolsFailed to connect to MySQL at localhost:3306MySQL 未启动或密码错误检查服务状态修改认证插件提示分区根目录空间不足虚拟磁盘分区过小扩展虚拟磁盘或清理缓存6. 几个让我节省大量时间的配置技巧最后分享几个我在实际使用中觉得特别值得做的事。第一及时打快照。每次环境配置好、装完关键软件之后都打一个快照。比如装完系统打一个干净系统快照配完开发环境打一个基础环境快照。这样以后出问题回到快照点非常快不需要重新从头配置一遍。我最早没有这个习惯装坏一次系统就得花半天重装。第二配置终端自动补全和快捷键。Ubuntu 默认终端按 Tab 可以补全命令和路径但很多人不知道连按两下 Tab 会列出所有可能的选项。这个功能在记不全文件名时特别管用。第三局域网内共享文件用 SSH 而不是图形界面拖拽。虚拟机里启用 SSH 服务宿主机上直接用命令传输文件和目录sudo apt install openssh-server sudo systemctl enable ssh然后在宿主机上就能用 SSH 客户端或者 scp、sftp 命令来传文件。速度比剪贴板复制快多了而且不会受剪贴板长度限制。第四虚拟机磁盘文件备份。虚拟机本质上就是几个文件直接把虚拟机的目录复制到移动硬盘上就是一份完整的系统备份。我第一次这么干之后再也没担心过系统崩溃的问题。这些技巧看着不起眼但在实际使用中带来的便利是巨大的。折腾 Linux 虚拟机的路上最大的敌人往往不是技术难度而是信息差——你不知道某个功能存在就会花很长时间去做一件其实很简单的替代品。希望上面这些内容能帮你少走一些弯路。