Ubuntu 24.04 使用 Snap 安装 code-server、CLion、PyCharm、JetBrains Toolbox 完整教程
本教程提供在 Ubuntu 24.04 系统上通过 Snap 包管理器安装四款开发工具的详细步骤、配置方法及常见问题解决方案,适合快速搭建开发环境。
一、准备工作:确保 Snap 已安装并正常工作
Ubuntu 24.04 通常预装 Snap,但建议先执行以下命令确保最新并启用经典模式支持:
bash
# 更新系统包列表
sudo apt update && sudo apt upgrade -y
# 安装/修复 snapd(如未安装)
sudo apt install -y snapd
# 启用 snap 经典模式支持(创建必要的符号链接)
sudo ln -s /var/lib/snapd/snap /snap
# 重启 snapd 服务(可选,确保服务正常)
sudo systemctl enable --now snapd.socket
安装完成后,注销并重新登录系统,确保 Snap 路径已正确加载。
二、Snap 安装四款工具详细步骤
📦 1. 安装 code-server(浏览器版 VS Code)
bash
# 安装 code-server(无需 --classic,默认沙盒模式)
sudo snap install code-server
# 验证安装
code-server --version
基础配置与启动
-
首次启动(生成默认配置):
bashcode-server首次启动会在
~/.config/code-server/config.yaml生成配置文件,包含随机密码。 -
自定义配置(修改端口、绑定地址、密码):
bashnano ~/.config/code-server/config.yaml编辑内容示例(允许外部访问):
yamlbind-addr: 0.0.0.0:8080 # 绑定所有网卡,端口8080 auth: password password: your_secure_password # 自定义密码 cert: false # 禁用HTTPS(测试环境)bash# 放行 8080 端口 sudo ufw allow 8080/tcp # 查看防火墙状态 sudo ufw status -
服务管理(systemd):
bash# 启动服务 sudo systemctl start code-server@$USER # 设置开机自启 sudo systemctl enable code-server@$USER # 查看状态 sudo systemctl status code-server@$USER -
访问方式 :浏览器打开
http://服务器IP:8080,输入配置的密码即可使用。
🛠️ 2. 安装 CLion(C/C++ 开发 IDE)
bash
# 安装 CLion 社区版(免费)
sudo snap install clion --classic
# 验证安装并启动
clion --version
说明 :
--classic参数必须添加,因为 CLion 需要完整的系统访问权限(如访问编译器、调试器等)。
🐍 3. 安装 PyCharm 社区版(Python 开发 IDE)
bash
# 安装 PyCharm 社区版(免费)
sudo snap install pycharm-community --classic
# 验证安装并启动
pycharm-community --version
说明 :专业版安装命令为
sudo snap install pycharm-professional --classic,需付费激活。
🧰 4. 安装 JetBrains Toolbox(IDE 统一管理工具)
bash
# 安装 JetBrains Toolbox
sudo snap install jetbrains-toolbox
# 验证安装并启动
jetbrains-toolbox
解决 Toolbox 常见权限问题(关键!)
若启动时出现 AccessDeniedException 或日志目录缺失错误,执行以下命令修复:
bash
# 1. 杀死所有残留进程
pkill -9 jetbrains-toolbox
# 2. 创建缺失目录并修复权限
mkdir -p ~/.cache/JetBrains/Toolbox
mkdir -p ~/.local/share/JetBrains/Toolbox/logs/{main,secondary}
chmod -R 755 ~/.cache/JetBrains ~/.local/share/JetBrains
# 3. 重新启动
jetbrains-toolbox
三、Snap 常用管理命令(统一参考)
| 操作 | 命令 |
|---|---|
| 查看已安装 Snap | snap list |
| 手动更新所有 Snap | sudo snap refresh |
| 手动更新单个工具 | sudo snap refresh code-server clion pycharm-community jetbrains-toolbox |
| 卸载工具 | sudo snap remove <工具名>(如 sudo snap remove clion) |
| 查看工具信息 | snap info <工具名> |
| 查看 Snap 日志 | journalctl -u snapd |
四、使用 JetBrains Toolbox 安装/管理 IDE(推荐)
Toolbox 安装后,可通过图形界面统一管理所有 JetBrains IDE,步骤如下:
- 启动 Toolbox :应用菜单搜索"JetBrains Toolbox"或终端执行
jetbrains-toolbox - 登录账号(可选,用于配置同步)
- 安装 IDE :
- 在 Toolbox 界面中找到 CLion/PyCharm,点击"Install"
- 可选择版本(稳定版/EAP)和安装路径
- 启动 IDE:安装完成后,Toolbox 会创建桌面图标,也可在 Toolbox 中直接启动
- 更新管理:Toolbox 会自动检测更新,支持一键更新或设置更新时间
五、常见问题与解决方案
1. Toolbox 启动报错:Logging is misconfigured
原因 :日志目录缺失或权限不足
解决 :执行[安装 Toolbox 部分](#安装 Toolbox 部分)的权限修复命令
2. IDE 无法找到编译器/解释器
原因 :Snap 沙盒限制或未安装开发工具链
解决:
- 安装必要工具链:
sudo apt install build-essential gcc g++ python3 python3-pip - 确保 IDE 使用
--classic模式安装(本教程已包含)
3. code-server 无法外部访问
原因 :绑定地址为 127.0.0.1(仅本地访问)
解决 :修改配置文件 ~/.config/code-server/config.yaml,将 bind-addr 改为 0.0.0.0:8080,并重启服务
4. Snap 安装速度慢
解决:更换 Snap 镜像源(临时加速):
bash
sudo snap set system proxy.http=http://your-proxy:port
sudo snap set system proxy.https=http://your-proxy:port
六、两种安装方式对比(直接 Snap vs Toolbox)
| 特性 | 直接 Snap 安装 IDE | Toolbox + Snap 安装 IDE |
|---|---|---|
| 安装复杂度 | 极低(一条命令) | 低(先装 Toolbox,再装 IDE) |
| 版本管理 | 单一版本(需切换 channel) | 多版本共存,一键切换 |
| 更新机制 | 自动后台更新 | 智能更新(支持补丁更新,可选择时机) |
| 配置同步 | 手动配置 | 支持 JetBrains 账号云同步 |
| 适用场景 | 单 IDE 简单使用 | 多 IDE 开发,重视版本管理 |
七、总结与建议
- 快速使用单 IDE :直接用 Snap 安装对应工具(如仅用 PyCharm:
sudo snap install pycharm-community --classic) - 多 IDE 长期开发:优先安装 JetBrains Toolbox,通过它统一管理所有 IDE,享受版本管理和配置同步便利
- code-server:适合远程开发或浏览器内编程,配置简单,启动后即可通过浏览器访问
所有工具均为官方维护的 Snap 包,自动更新 且卸载无残留,是 Ubuntu 24.04 上搭建开发环境的高效方式。
需要我给你一套一键安装+配置的脚本(含code-server、CLion、PyCharm社区版、Toolbox,以及必要依赖和常见问题修复)吗?