1. 为什么选择在Ubuntu上安装VSCode
作为一名长期在Linux环境下工作的开发者,我深刻体会到代码编辑器对开发效率的决定性影响。Visual Studio Code(简称VSCode)作为微软推出的开源编辑器,近年来已经成为Linux平台上的首选开发工具之一。根据Stack Overflow 2023年开发者调查,VSCode以74.48%的使用率稳居最受欢迎开发环境榜首。
在Ubuntu上使用VSCode有几个显著优势:
- 轻量级但功能强大:相比完整的IDE,VSCode启动更快、资源占用更低,特别适合Ubuntu这种常用于老设备的系统
- 跨平台一致性:无论你在Windows、Mac还是Linux上开发,都能获得几乎相同的体验
- 丰富的扩展生态:通过插件市场可以支持几乎所有主流编程语言和开发场景
- 深度集成终端:内置终端完美适配Ubuntu的各种命令行工具
注意:虽然Ubuntu自带gedit等文本编辑器,但对于现代软件开发来说,这些工具的功能远远不够。VSCode提供了代码补全、调试、Git集成等专业开发所需的核心功能。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装前的系统准备
2.1 检查系统版本
在开始安装前,建议先确认你的Ubuntu版本。打开终端(Ctrl+Alt+T)并执行:
bash复制lsb_release -a
典型输出如下:
code复制No LSB modules are available.
Distributor ID: Ubuntu
Description: Ubuntu 22.04.3 LTS
Release: 22.04
Codename: jammy
VSCode官方支持Ubuntu 16.04及更高版本,但推荐使用18.04以上以获得最佳体验。对于长期支持版(LTS),如20.04或22.04,可以获得最稳定的兼容性。
2.2 更新系统包
安装前更新系统包可以避免依赖问题:
bash复制sudo apt update && sudo apt upgrade -y
这个命令会:
- 更新本地包索引(
apt update) - 升级所有可更新的包(
apt upgrade) -y参数自动确认所有提示
2.3 安装必要依赖
某些VSCode功能需要额外的库支持:
bash复制sudo apt install -y software-properties-common apt-transport-https wget
这些包的作用分别是:
software-properties-common:管理PPA仓库apt-transport-https:支持通过HTTPS协议下载wget:命令行下载工具
3. 三种安装方法详解
3.1 通过.deb包直接安装(推荐)
这是最直接的方法,适合大多数用户:
-
访问VSCode官网下载页面:
bash复制xdg-open "https://code.visualstudio.com/download"或手动下载:
bash复制
wget https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64 -O vscode.deb -
安装下载的.deb包:
bash复制sudo dpkg -i vscode.deb -
解决可能的依赖问题:
bash复制sudo apt install -f
提示:如果下载速度慢,可以尝试微软的国内镜像:
bash复制wget https://vscode.cdn.azure.cn/stable/6c3e3dba23e8fadc360aed75ce363ba185c49794/code_1.81.1-1691620686_amd64.deb
3.2 通过APT仓库安装(适合长期使用)
这种方法可以方便地接收自动更新:
-
导入微软GPG密钥:
bash复制wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/ -
添加VSCode仓库:
bash复制echo "deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/vscode stable main" | sudo tee /etc/apt/sources.list.d/vscode.list -
更新并安装:
bash复制sudo apt update sudo apt install code
3.3 通过Snap安装(最简单但可能有延迟)
Ubuntu自带Snap支持,可以一键安装:
bash复制sudo snap install --classic code
但需要注意:
- Snap版本更新可能比官方渠道晚1-2周
- 某些扩展在Snap环境下可能有权限问题
- 首次启动可能较慢
4. 首次配置与优化
4.1 解决中文显示问题
如果遇到中文显示为方块:
- 安装中文字体:
bash复制sudo apt install fonts-noto-cjk - 在VSCode设置中(Ctrl+,)搜索"font family",添加:
code复制'Noto Sans CJK SC', 'Microsoft YaHei', sans-serif
4.2 推荐必装扩展
根据开发语言不同,推荐安装:
- 通用:
- Chinese (Simplified) Language Pack:中文界面
- Settings Sync:配置云端同步
- Web开发:
- ESLint
- Live Server
- Prettier
- Python:
- Python
- Pylance
- C/C++:
- C/C++
- CMake Tools
安装命令示例:
bash复制code --install-extension ms-python.python
4.3 性能优化设置
在settings.json中添加:
json复制{
"files.autoSave": "afterDelay",
"editor.fontSize": 14,
"window.zoomLevel": 0,
"telemetry.telemetryLevel": "off",
"update.mode": "default",
"git.enableSmartCommit": true
}
5. 常见问题排查
5.1 启动报错"libgtk-3.so.0 not found"
解决方法:
bash复制sudo apt install libgtk-3-0
5.2 扩展安装失败
可能原因及解决:
- 网络问题:尝试设置代理
bash复制code --proxy-server="http://your.proxy:port" - 权限问题:用sudo启动一次VSCode
- 缓存问题:删除
~/.vscode/extensions后重试
5.3 终端无法使用
检查:
- 默认终端设置是否正确(Ctrl+,搜索"terminal.integrated.defaultProfile.linux")
- 是否安装了bash:
bash复制sudo apt install bash
6. 高级使用技巧
6.1 远程开发配置
通过Remote - SSH扩展可以连接远程服务器:
- 安装扩展:Remote - SSH
- 按F1,选择"Remote-SSH: Connect to Host"
- 输入
username@hostname
6.2 集成WSL2
如果在Windows上使用Ubuntu on WSL:
- 安装WSL扩展
- 按F1,选择"Remote-WSL: New Window"
- 所有操作将在WSL环境中执行
6.3 自定义代码片段
创建常用代码模板:
- 文件 > 首选项 > 用户片段
- 选择语言类型
- 添加如下的JSON:
json复制{
"Print to console": {
"prefix": "log",
"body": [
"console.log('$1');",
"$2"
],
"description": "Log output to console"
}
}
7. 卸载与清理
如果需要卸载VSCode:
.deb安装方式:
bash复制sudo apt remove code
sudo apt purge code
Snap安装方式:
bash复制sudo snap remove code
清理配置:
bash复制rm -rf ~/.vscode
rm -rf ~/.config/Code
