Skip to content

VS Code 便携版安装:免安装器 + 右键菜单 + 数据隔离

VS Code 官方提供三种安装方式:User Installer(用户级安装器)、System Installer(系统级安装器)和 zip 压缩包。绝大多数人选择安装器,双击一路"下一步"就装好了。但很少有人知道,VS Code 还支持一种便携模式(Portable Mode),它能把配置、扩展、缓存全部隔离在应用目录内,不往注册表和 AppData 里写任何东西。

为什么选便携版?

用安装器装的 VS Code,设置文件散落在 %APPDATA%\Code\,扩展装在 %USERPROFILE%\.vscode\extensions\,卸载后这些残留不会被清理。换台电脑或重装系统,所有配置都得重新来过。

便携版的做法不同。只要在 VS Code 根目录下创建一个 data/ 文件夹,VS Code 就会自动进入便携模式:

  • settings.json 存在 data/user-data/
  • 扩展 装在 data/extensions/
  • 缓存 也在 data/ 内部

所有东西都在一个目录里。备份就是复制文件夹,迁移就是把整个目录拷到新机器。不污染注册表,不修改 AppData,删除目录即完成卸载。

手动配便携版的麻烦

虽然原理简单,但手动操作还是有不少步骤:

  1. 去官网下载 zip 包(国内访问经常很慢)
  2. 解压到合适的目录
  3. 手动创建 data/ 文件夹
  4. 把 VS Code 所在路径手动添加到系统 PATH
  5. 如果想要右键菜单"通过 Code 打开",需要手动编辑注册表

尤其是右键菜单,安装器版会自动注册,但 zip 便携版没有这个待遇。你得自己写三条注册表项:文件右键、文件夹右键、文件夹空白处右键,还要配置图标和命令参数。

用 hudo 一条命令搞定

hudo 把上面所有步骤自动化了:

powershell
hudo install vscode

这条命令会依次完成:

  1. 下载最新 zip 包:从官方地址下载,如果速度太慢会自动回退到 Azure 中国 CDN 镜像
  2. 解压到 ide\vscode\:放在 hudo 统一管理的安装根目录下
  3. 创建 data/ 目录:自动激活便携模式,配置和扩展从此与应用绑定
  4. 注册 PATH:把 VS Code 根目录和 bin/ 子目录加入用户 PATH,终端里直接用 code 命令
  5. 注册右键菜单:写入 HKCU\Software\Classes 下三条注册表项,不需要管理员权限

注册的右键菜单支持三种场景:

  • 右键任意文件 → 通过 Code 打开
  • 右键任意文件夹 → 通过 Code 打开
  • 在文件夹空白处右键 → 通过 Code 打开当前目录

安装后验证

安装完成后,打开一个新的终端窗口:

powershell
code --version

能看到版本号说明 PATH 已生效。在文件资源管理器里随便找个文件夹,右键菜单里应该能看到「通过 Code 打开」。

升级不丢配置

hudo 升级 VS Code 时会先备份 data/ 目录,解压新版本后再把 data/ 放回去。你的设置、扩展、快捷键全部保留,和之前一模一样。

迁移到另一台电脑

这是便携版最实用的场景。把整个 ide\vscode\ 目录复制到新机器的相同路径下,然后运行:

powershell
hudo install vscode

hudo 检测到已有安装时会保留 data/ 目录,只更新 VS Code 本体并重新注册环境变量和右键菜单。你的所有配置无缝迁移,不需要登录 Settings Sync,不需要重新装扩展。

卸载也干净

powershell
hudo uninstall vscode

卸载时 hudo 会自动清理之前写入的右键菜单注册表项和 PATH 条目。因为是便携版,没有散落在系统各处的残留文件,删了就是真的删干净了。


VS Code 便携版是 Windows 上最干净的使用方式,配合 hudo 的自动化安装,既不牺牲便利性,又保持了系统的整洁。如果你还在用安装器版,不妨试试这个方案。


查看 VS Code 工具文档 了解完整安装参数与配置选项。

基于 MIT 协议发布