接触Linux的朋友应该都懂装软件这件事在Ubuntu上永远有不止一条路。VS Code作为目前开发圈最主流的编辑器安装方式自然也有好几种但坑也真不少。有些教程让你去官网下载deb包有些让你用snap一条命令装完还有的推荐直接用AppImage——我当年第一次在Ubuntu上装VS Code时就因为在软件商店里点了个安装结果打开之后字体模糊、扩展装不上、终端里还敲不出code命令折腾了一下午。这篇文章我就把这几年在Ubuntu上安装、配置、维护VS Code的经验全部翻出来从最推荐的安装方式讲起把网上那些教程没提过的细节和踩坑记录一并整理清楚。无论你是刚从Windows迁移过来的新手还是已经在Linux打滚多年的老手这套方案都能让你的VS Code装得干净、跑得稳。1. 安装前先搞清楚Ubuntu装VS Code有哪几条路1.1 四种常见安装方式对比先掰扯清楚整体思路。网上搜“Ubuntu安装VS Code”你能找到的无非是下面四种方式Ubuntu软件商店Snap版图形化界面里搜“Visual Studio Code”直接点安装适合完全不想碰命令行的用户。官网下载deb包打开code.visualstudio.com下载deb文件双击安装很多教程推荐这个。微软官方apt源安装把微软的软件源添加到系统里然后用apt install code安装。AppImage便携版解压即用不写入系统适合U盘党或者不想污染系统的洁癖用户。四种方式各有适用场景但我的结论很明确装VS Code首选第三条路也就是通过微软官方apt源安装。为什么这么选不是我偏心命令行而是这条路在实际使用中的长期体验最好。软件源方式装完的VS Code会跟随apt update自动更新不会出现“软件商店里老提示有新版本但是点更新半天没反应”的尴尬。deb包虽然一次性装上没问题但后续每次升级都得重新去官网下载实在太麻烦了。AppImage虽然不用安装但每次打开前要设置执行权限版本更新还得手动下载覆盖站在专业开发者的角度很难接受。1.2 判断自己该选哪种方式总结一个简单的判断标准照着选就行只想体验一下打算装完就删选AppImage不写入系统任何配置删掉文件等于完全卸载。日常使用但不熟悉命令行选软件商店版本功能上基本没差别。开发主力机长期使用直接用apt源方案往下走自动更新省心命令行和图形界面都能启动。服务器或容器环境只有命令行apt源方案同样适用连图形桌面都不需要。确定好方案下面直接进入实操环节。我在新装的Ubuntu 22.04 LTS和24.04 LTS上都跑过完整流程命令可以照抄。2. 完整安装流程从零开始把VS Code装进Ubuntu2.1 更新系统基础组件正式开始装VS Code之前先做一件事把系统里已有的软件包刷新一遍同时安装后续会用到的几个基础工具。打开终端依次执行sudo apt update sudo apt upgrade -y这个步骤看着多余但实际上非常重要。如果你在全新安装的Ubuntu上直接添加新软件源经常会遇到curl: command not found或者gpg: command not found的报错就是因为系统缺少相关软件包。与其等报错出现再补救不如提前装好。顺手把这几样也装上sudo apt install -y wget gpg apt-transport-https这里简单解释一下每个包的作用wget下载文件的命令行工具后面拉取微软GPG密钥和仓库信息要用。gpgGNU隐私卫士用来验证下载的密钥文件和软件包签名保证来源可信。apt-transport-https让apt支持通过HTTPS协议访问软件源如果不装添加微软源的时候会提示“不支持https”。这些包都不大加起来几MB而已装了不亏。2.2 添加微软官方GPG密钥与软件源接下来是核心步骤把微软的官方软件源加入系统的apt源列表。这一步分为两块导入GPG密钥相当于验证码告诉apt“这个源是微软亲生的”然后写入源配置。第一步导入GPG密钥wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor packages.microsoft.gpg sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg解释一下这两行做了什么第一行从微软服务器下载密钥文件并用gpg --dearmor把ASCII格式的密钥转换成二进制这一步是为了让apt能正常读取第二行把转换后的密钥文件放到系统统一的密钥目录/etc/apt/keyrings/并修改归属和权限。第二步写入软件源配置sudo sh -c echo deb [archamd64,arm64,armhf signed-by/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main /etc/apt/sources.list.d/vscode.list这里要注意架构参数。我写的archamd64,arm64,armhf覆盖了目前主流的x86_64和ARM架构。如果你用的是树莓派或某些ARM架构的开发板这个配置一样能用。如果只需要x86_64平台写archamd64就够了问题也不大。第三步刷新源并安装sudo apt update sudo apt install -y codeapt update会读取新添加的源并拉取软件列表过程看到“Get:5 https://packages.microsoft.com/repos/code stable/main [xxx kB]”就说明源配对了。安装完以后在终端输入code --version能输出版本号就说明安装成功。我的环境里看到的输出类似这样1.90.0 4a8a7a1a8f3c1a5e0e6c1b3f5c7b2f8d4e6a9e1 arm642.3 通过图形界面启动与终端命令绑定安装完成后你可以在应用菜单里搜索“Visual Studio Code”点击图标打开也可以直接在终端输入code命令启动。这里有个很贴心的设计VS Code安装包默认会在/usr/bin下创建code软链接所以不需要额外配置终端里就能直接唤起。我在实际使用中最顺手的启动方式是这样的# 直接打开当前目录 code . # 打开指定文件 code ~/Documents/notes.md # 打开多个文件夹会新开一个窗口 code ~/project-a ~/project-b如果你执行code .以后终端卡住不动或者提示“command not found”大概率是下面两种情况之一安装时用了Snap版Snap版的命令是snap run code且不会自动创建code软链接。建议用前面的apt源方式重装一遍一劳永逸。PATH环境变量问题可以去/usr/bin/code确认软链接是否存在如果不存在手动创建sudo ln -s /usr/share/code/bin/code /usr/bin/code。另外还有一个常见痛点在终端里启动VS Code后终端一直显示“正在运行”新人很容易以为卡死了。其实这是正常现象因为code命令把日志输出绑定到了当前终端。想摆脱这种绑定可以改用code . /dev/null 这样启动后终端不会卡住命令也立即返回体验会好很多。我习惯直接alias codecode . /dev/null 但要注意这个别名会把参数忽略掉所以实际我更推荐写个函数不过这里就不展开讲了。3. 装完必做汉化、字体与界面优化3.1 设置界面为中文VS Code安装后默认是英文界面对英语不太熟悉的朋友会觉得不友好。装中文语言包的办法很简单在扩展面板里搜索“Chinese (Simplified) (简体中文) Language Pack”安装后右下角会弹出“更改语言并重启”的提示点击后整个界面就会切换成中文。如果你没看到系统弹窗也可以手动设置按CtrlShiftP打开命令面板输入“Configure Display Language”选择“中文(简体)”重启即可。这里插一句我见过很多人只装语言包不重启或者重启后界面还是英文急得不行。原因大多是复写了locale.json却被改了默认配置。遇到这种情况最快的方法是直接编辑locale.json文件把locale: en改成locale: zh-cn保存重启一定生效。3.2 字体设置向macOS的渲染质感靠拢热搜词里有一条特别有意思“wsl ubuntu写代码最推荐的字体接近macos的体验”。我猜这是很多从Mac切换到Linux开发的程序员共同的诉求。Mac上代码之所以看着舒服核心因素是两个字体选择对了渲染效果细腻。先说字体。我个人比较推荐在Ubuntu上用JetBrains Mono它和Mac上常用的Menlo、Monaco比例接近带连字功能英文和符号的区分度很好。安装方式sudo apt install -y fonts-jetbrains-mono装完后在VS Code的设置里搜索“Font Family”填入JetBrains Mono, Droid Sans Mono, monospace再说渲染。Linux上字体的清晰度和微调hinting有很大关系如果你觉得界面里的字体发虚可以在终端执行gsettings set org.gnome.desktop.interface font-antialiasing rgba gsettings set org.gnome.desktop.interface font-hinting slight这两条命令把系统的抗锯齿模式设置为RGBA子像素渲染字体的边缘会平滑很多对高分屏提升尤其明显。不过要提醒一句如果你用的不是GNOME桌面比如KDE或者XFCE这条命令不生效需要在各自的系统设置里找对应的字体内微调选项。3.3 设置窗口缩放与图标主题很多从Windows迁过来的朋友觉得Ubuntu上VS Code字体太小第一反应是去改编辑器字号。其实更聪明的做法是直接调整个界面的缩放比例按CtrlShiftP执行“Toggle Window Zoom”或者直接比Ctrl放大窗口。这个操作对整体界面生效包括侧边栏、菜单、状态栏体验比单独调字体字号好太多。如果你是高分屏用户比如2K、4K显示器还可以在启动参数里指定缩放因子code --force-device-scale-factor1.25嫌每次输命令麻烦的话可以在~/.bashrc里加一行alias。实测这个参数在Ubuntu 22.04Wayland环境下效果稳定不会出现窗口模糊或缩放比例不对的问题。4. 核心开发环境配置Python和C/C跑起来4.1 Python环境配置VS Code刚装上时对Python项目只有基础的语法高亮想要智能提示、调试、代码检查需要装两样东西Python扩展和虚拟环境。完整的流程我之前写过不少这里说最精简的版本。**第一步安装Python扩展**在扩展面板搜索“Python”微软官方出品安装即可。这个扩展会连带安装Pylance负责智能感知和类型检查和Python Debugger。**第二步创建虚拟环境**VS Code配合虚拟环境是标准姿势。在你的项目目录下执行python3 -m venv .venv source .venv/bin/activate激活后终端路径前面会出现(.venv)前缀。这时候在VS Code里按CtrlShiftP运行“Python: Select Interpreter”选中你刚创建的虚拟环境。只要选对了代码补全、语法检查、调试工具都会自动指向这个环境不会污染系统Python。**第三步配置代码检查工具**VS Code的Python扩展默认使用Pylint做代码检查但我个人更推荐Flake8输出更简洁规则更符合主流项目习惯。在扩展设置里搜索“Python Linting: Flake8 Enabled”勾选后关闭Pylint即可。实测Flake8对新人最友好不太会报一些劝退型错误。4.2 C/C编译与调试配置在Ubuntu上用VS Code写C/C第一件事是确认编译器和调试器都装了。很多人在这栽跟头只装了VS Code就以为万事大吉结果一编译就报“gcc: command not found”。执行sudo apt install -y build-essential gdbbuild-essential包含gcc、g和makegdb是调试器。装好之后VS Code里装Microsoft官方C/C扩展扩展IDms-vscode.cpptools。要让F5能直接编译和调试得在项目根目录下创建.vscode/tasks.json和.vscode/launch.json两个文件。我一般是用CtrlShiftP输入“C/C: Add Debug Configuration”让扩展自动生成模板再手动微调。核心配置如下tasks.json编译任务{ version: 2.0.0, tasks: [ { label: C/C: g build active file, type: cppbuild, command: /usr/bin/g, args: [ -fdiagnostics-coloralways, -g, ${file}, -o, ${fileDirname}/${fileBasenameNoExtension} ], options: { cwd: ${fileDirname} }, problemMatcher: [$gcc], group: { kind: build, isDefault: true } } ] }launch.json调试配置{ version: 0.2.0, configurations: [ { name: C/C: g build and debug active file, type: cppdbg, request: launch, program: ${fileDirname}/${fileBasenameNoExtension}, args: [], stopAtEntry: false, cwd: ${fileDirname}, environment: [], externalConsole: false, MIMode: gdb, setupCommands: [ { description: Enable pretty-printing for gdb, text: -enable-pretty-printing, ignoreFailures: true } ], preLaunchTask: C/C: g build active file, miDebuggerPath: /usr/bin/gdb } ] }配置完成后打开一个.cpp文件按F5就能编译并进入调试模式。这里面的${file}、${fileDirname}这些变量是VS Code内置的分别代表当前文件路径和所在目录不需要修改。4.3 C/C扩展偶尔抽风怎么办我在Ubuntu上遇到过两次C/C扩展突然无法加载的情况症状是代码里波浪线全部消失右键没有“Go to Definition”选项。解决方法是点击扩展面板里C/C扩展旁边的齿轮选择“Extension Settings”搜索“C_Cpp: Intelli Sense Engine”把值切换成“Tag Parser”再切回“Default”。这个操作会强制扩展重启语言服务90%的情况能恢复。如果这个办法没用再执行rm -rf ~/.cache/Microsoft/vscode-cpptools/把缓存清掉重启VS Code基本就稳了。5. WSL和远程开发场景把VS Code用到极致5.1 WSL里无缝调用VS CodeWindows用户经常用WSL跑Ubuntu然后在WSL里写代码。这确实是目前开发环境里体验很好的一套组合拳。安装WSL后在终端执行wsl --install然后进入WSL里的Ubuntu系统安装VS Code的Windows版后注意不是WSL内安装Linux版在WSL终端里输入code .这时候会自动调用Windows侧的VS Code并启动WSL扩展连接到Linux环境文件浏览、终端、调试全部在WSL里执行但界面还是Windows那个流畅的VS Code。这个方案的体验已经非常接近原生开发了跑Node.js、Python、Go都毫无压力。如果你经常在Windows和Linux之间来回切换强烈推荐这个方案。5.2 通过Remote-SSH连接远程服务器很多人的代码是在云服务器或者公司内网的Linux机器上跑着的VS Code的Remote-SSH扩展是管理这类代码的利器。装好扩展以后按CtrlShiftP输入“Remote-SSH: Connect to Host”填上root你的服务器IP即可。这个场景下有几个高频问题我直接做成速查表问题现象原因解决方法连不上提示Permission deniedSSH密钥不对或没配置确认本地~/.ssh/id_rsa.pub已添加进服务器~/.ssh/authorized_keys连上了但VS Code窗口卡在“正在加载”服务器上没有安装VS Code Server确保服务器上curl和wget可用VS Code会自动下载传输大文件时连接中断网络不稳定VS Code设置里搜索“Remote.SSH: Server Install Path”改到有空间的分区中文文件名乱码服务器locale设置不对在服务器执行export LANGen_US.UTF-8或修改/etc/locale.gen说到SSH连不上问题热搜里有一条“ubuntu ssh无法连接”这经常是端口没开或者sshd服务没启动。排查思路很简单先在服务器本地执行sudo systemctl status ssh看服务是否运行再执行sudo ufw allow 22/tcp放行防火墙端口最后从客户端测试ssh 用户名IP -p 22逐层排除基本都能定位。5.3 环境变量写错导致命令失效的急救方案热搜词里还有一条“ubuntu环境变量配置错误”这是在Linux上开发逃不掉的坑。最常见的情况是编辑~/.bashrc时把PATH变量写错了导致终端里连ls、sudo都提示找不到。遇到这种情况别慌因为系统命令大部分在/usr/bin、/bin这些绝对路径下直接用绝对路径就能修复。/usr/bin/echo $PATH /usr/bin/nano ~/.bashrc把改错的行注释掉保存后执行source ~/.bashrc基本恢复。如果终端都进不去可以重启进入恢复模式或者用export PATH/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin紧急修复。这个应急方案我每年都要用上好几回分享出来希望你用不上但一定要知道。6. 常用插件与性能优化让VS Code更好用6.1 我日常必装的七款插件VS Code的强大有一半靠插件但插件也不是越多越好。装得太多启动速度明显变慢界面也臃肿。以下是我在Ubuntu上每台机器都装的精简组合Pythonms-python.pythonPython开发必备集成了调试、测试、代码分析。C/Cms-vscode.cpptoolsC/C语言服务的完整解决方案。Remote - SSHms-vscode-remote.remote-ssh远程开发的灵魂插件。GitLenseamodio.gitlens把Git历史、代码作者、分支信息全部可视化。Material Icon Themepkief.material-icon-theme文件图标美观度提升十倍。Bracket Pair Colorizercoenraads.bracket-pair-colorizer括号配色区分写嵌套代码时救大命。Prettier - Code formatteresbenp.prettier-vscode前端代码格式化第一选择。装插件统一用CtrlShiftX打开扩展面板搜索安装即可。我在生产环境里还常用Docker扩展配合热搜词里的“ubuntu安装docker”一起说VS Code的Docker扩展能直接右键容器附加终端、查看日志、管理镜像比命令行手敲舒服太多了。6.2 扩展安装慢或失败的解决思路Ubuntu上装VS Code扩展如果安装在服务器或网络环境受限的机器上经常会遇到扩展下载失败的提示。这里我不展开具体网络方案只分享一个思路VS Code扩展的下载源可以换成国内的可访问镜像地址。在~/.bashrc或系统环境变量中加入VSCODE_CACHE/tmp然后重启VS Code再试很多时候就能跳过缓存导致的下载失败。如果某个扩展反复装不上还可以去VS Code扩展市场网站下载vsix文件通过扩展面板右上角的“... - Install from VSIX...”手动安装。这个方法离线环境也适用算是比较通用的后备方案。6.3 启动太慢试试这几招VS Code装了二十个以上插件后启动速度会明显下降。我自己实测了一套调优方案禁用不常用扩展扩展面板里逐个关闭不常用的需要时再启用不影响任何配置。关闭部分自动检查设置里搜索“Editor: Format On Save”默认关闭需要时手动CtrlShiftI格式化。减少工作区文件监视设置里搜索“Files.watcherExclude”加入**/node_modules/**、**/vendor/**等编译生成目录文件监听压力大减CPU占用会明显下降。用Wayland原生渲染Ubuntu 22.04如果使用Wayland会话可以用code --ozone-platformwayland启动VS Code界面渲染走GPU滚动流畅度高不少。不过注意个别扩展和Wayland有兼容性问题如果出现界面闪烁改回--ozone-platformx11即可。7. 常见问题速查Ubuntu下VS Code报错自救指南把我在各个博客评论区看到的高频问题汇总一下做成一张速查表遇到问题先对号入座报错/现象可能原因快速解决E: Package code has no installation candidate软件源没配好检查/etc/apt/sources.list.d/vscode.list里密钥路径是否正确启动后界面全是方格/乱码系统缺字体sudo apt install -y fonts-noto-cjkCommand code not found用了Snap版或安装不完整按本文第二章节重装apt版扩展安装失败无详细报错网络或域名解析问题手动下载vsix安装或稍后再试终端输出/usr/share/code不存在安装路径被清理或占用重装sudo apt install --reinstall -y code保存文件时提示无权限文件归属root或目录只读检查文件ls -l确认用户对目录有写权限代码折叠全部失效语言服务崩溃CtrlShiftP运行“Developer: Reload Window”打开Git仓库卡死仓库过大或文件监控超载设置里搜索“Git: Auto Refresh”改为false这张表里的问题90%我在自己或朋友的机器上亲手处理过。如果你也遇到了但解决不了先重启一次VS Code再重启一次Ubuntu——这个建议听起来很入门但确实能解决一大半莫名其妙的问题。再分享一个压箱底的排查技巧VS Code在启动异常时会输出详细日志在终端执行code --verbose可以看到完整启动过程。如果你的问题反复出现把日志末尾几十行的报错信息贴到搜索引擎里多半能找到同病相怜的人和现成答案。这点耐心和搜索功夫比死磕一个问题一小时有用得多。写在最后这套Ubuntu下安装VS Code的流程我在自己的主力机上已经跑了两年多经历了从22.04到24.04的升级期间换过三次主板系统重装过两回唯一不变的配置方案就是上面这套微软官方apt源安装JetBrains Mono字体精简的插件组合配合Remote-SSH管理远程服务器。整个环境干净、稳定、不折腾。如果你打算把这套安装流程用在多台机器上我建议把从wget到sudo apt install -y code之间的命令整理成一个脚本存到自己的仓库里新机器克隆下来一键执行再也不用每个机器重复手敲。另外VS Code的配置同步功能Settings Sync记得开启登录GitHub账号后主题、快捷键、插件列表全平台同步换机器十分钟就能恢复到熟悉的开发环境。最后再分享一个从老前辈那里学到的习惯每当遇到Ubuntu下的软件问题养成先查/var/log/apt/下日志的习惯apt操作的行为都会记录在这里很多“莫名其妙”的错误其实都能从日志里找到根源。把这个习惯保持住你会发现自己对Linux系统的掌控力会上一个台阶。