VSCode 修改插件安装目录

摘要

使用4种方法修改 Visual Studio Code 插件的安装位置。

1. 修改环境变量
2. Portable mode
3. 命令行参数
4. 符号链接

插件默认安装位置：

• Windows %USERPROFILE%\.vscode\extensions
• macOS ~/.vscode/extensions
• Linux ~/.vscode/extensions

当前 VS Code 版本：1.109.0

方法一：通过环境变量 VSCODE_EXTENSIONS 修改插件目录

官方文档：Extension Marketplace
这是 VS Code 官方文档明确支持的方法之一。 设置后，VS Code 会全局使用指定的目录作为插件安装位置，不需要额外参数。

设置方法：

• Windows

  1. 创建插件目录，例如：D:\VSCodeExtensions

  2. 打开：Win + R → 输入 sysdm.cpl → 确定 → 高级 → 环境变量

  3. 新建系统变量：

     • 变量名：VSCODE_EXTENSIONS
     • 变量值：D:\VSCodeExtensions

  4. 可以将原插件目录 %USERPROFILE%\.vscode\extensions （例如：C:\Users\用户名\.vscode\extensions）下的全部文件拷贝到新插件目录，然后重启 VS Code 即可

• macOS / Linux

  1. 编辑 shell 配置文件修改环境变量：

  export VSCODE_EXTENSIONS="/home/username/vscode-ext"
  

  2. 然后执行：

  source ~/.zshrc   # 或 ~/.bashrc
  

方法二：使用 VS Code Portable Mode（便携版）

官方文档：Portable mode
Portable 模式是 VS Code 官方提供的“绿色版”，无需安装，所有数据（包括插件）都将存放在 VS Code 目录下。方便跨开发环境使用。

启用方法：

1. 只能使用 VS Code 压缩包版本（Windows: .zip, Linux: .tar.gz, ），下载见官方 Download Visual Studio Code；
2. 只需在根目录创建一个 data 文件夹

VS Code 会自动使用 data/extensions 作为插件目录。此方法下无法自动更新。

目录结构示例：

VSCode/├─ Code.exe└─ data/├─ user-data/└─ extensions/   ← 插件目录

方法三：使用命令行参数 --extensions-dir

官方文档：Command Line Interface (CLI)
VS Code 支持通过 CLI 参数指定插件目录的方法来打开软件；
类似于 Atom 可以用 --portable 定义数据目录，VS Code 也可以使用 --extensions-dir 指定插件安装目录来打开 VS Code。

使用方法：

• 创建好新插件目录（例如 D:\VSCodeExtensions ），然后在 CMD 或者 Shell 中执行以下命令即可：

  code --extensions-dir "D:\VSCodeExtensions"
  

  执行命令前可使用 code -v 命令判断 code 命令能否正确执行。例如 Windows：

  

• 也可以修改 VS Code 快捷方式（Windows）来快速启动（右键快捷方式→属性→目标）

  在 VS Code 快捷方式的“目标”字段末尾添加：

  --extensions-dir "D:\VSCodeExtensions"
  

  

VS Code 启动后将使用 D:\VSCodeExtensions 作为插件目录。

方法四：使用符号链接（Symbolic Link）重定向插件目录

符号链接：Symbolic link - Wikipedia
符号链接类似于快捷方式，允许文件和目录在多个位置显示为存在，但实际上它们只存在于一个物理位置。
如果不想修改 VS Code 的任何配置，则可以直接把默认插件目录替换成符号链接，让它指向想要的位置。

链接方法：

• Windows :

  1. 创建好新插件目录，例如 D:\VSCodeExtensions

  2. 将原插件目录 %USERPROFILE%\.vscode\extensions （例如：C:\Users\用户名\.vscode\extensions）下的全部文件拷贝到新插件目录D:\VSCodeExtensions

  3. 创建符号链接

     在 管理员身份下的 CMD 或者 PowerShell 中执行：

     mklink /D "%USERPROFILE%\.vscode\extensions" "D:\VSCodeExtensions"
     

• Linux / macOS ：

mv ~/.vscode/extensions /mnt/data/vscode-ext
ln -s /mnt/data/vscode-ext ~/.vscode/extensions

无需对 VS Code 做任何更改，插件目录就已被重定向。

总结：四种方法对比

方法	是否官方支持	是否全局生效	是否需要额外启动参数	适用场景
环境变量 VSCODE_EXTENSIONS	✔	✔	✘	最推荐、最稳定
Portable Mode	✔	✔	✘	便携、隔离环境
CLI 参数 --extensions-dir	✔	✘	✔	多套插件环境
符号链接	半官方（系统级）	✔	✘	想保持默认行为