2026年VS Code WSL主题美化方案 | 实测有效

▌ 技术引导
2026年VS Code在WSL环境下的主题美化方案已经可以用非常低的成本实现，关键在于结合最新的WSL2特性与VS Code的官方API，以及一些非官方但稳定可靠的插件。我见过不少人在使用WSL时，因为默认主题看起来灰扑扑的，连代码都懒得写。但如果你真的想让环境变得漂亮，只需要在终端配置上动点小手脚，就能让整个开发流程更舒服。比如，使用PowerShell作为默认终端，配合oh-my-posh和Solarized主题，就可以在WSH里实现一个接近Mac终端的风格。另外，如果使用Ubuntu，记得配置`~/.bashrc`文件里的PS1变量和字体设置，否则终端看起来会很别扭。如果你是在WSL2里使用Windows的资源管理器，记得调整字体大小和颜色，避免双系统界面不一致带来的视觉疲劳。别再用那些廉价的代码编辑器主题了，VS Code现在支持非常丰富的自定义选项，而且跟WSL的集成越来越深，真是一个好时代。

▌ 技术参考

一
WSL2的终端环境默认是bash，但如果你用的是PowerShell，那在VS Code中可以直接通过终端配置文件来替换默认shell。我见过很多人在WSL里装了PowerShell，却不知道怎么在VS Code中设置。打开`settings.json`文件，找到`terminal.integrated.shell.windows`这个配置项，替换成`C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe`即可。不过，得注意sys32目录下的powershell.exe是32位版本，有时候会报错。这时候可以改用`C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe`的64位版本，或者直接在WSL里安装PowerShell模块，这样在VS Code里调用就不会有问题。另外，如果你设置默认shell是PowerShell，记得同时调整`terminal.integrated.env.windows`里的`PSModulePath`，否则某些模块会找不到。

二
美化终端离不开字体和颜色的搭配。WSL2的终端在Windows上默认是Consolas字体，但如果你想要更清晰的显示效果，可以换成Fira Code or Cascadia Code这样的等宽字体。在VS Code中，设置`terminal.integrated.fontFamily`为`Fira Code`，同时设置`terminal.integrated.fontSize`为16。不过，这些字体在Windows系统里需要手动安装，否则VS Code可能无法识别。我之前在一台Windows 11设备上装了Fira Code，结果VS Code一直提示字体找不到，后来发现是因为字体没有在系统字体目录下注册。这时候可以去字体官网下载，然后放到`C:\Windows\Fonts`目录下，重启VS Code就OK了。字体颜色方面，建议用Solarized主题搭配深色背景，视觉上更舒适，也更符合现代开发者的审美。

三
终端美化的核心在于PS1变量的配置。对于PowerShell来说，PS1变量控制了命令提示符的显示形式，比如当前路径、当前用户、时间戳等。我在实际工作中用的是oh-my-posh这个工具，它可以提供非常丰富的shell主题。安装方法是`Invoke-Expression (&{$env:PSModulePath + "\oh-my-posh\Install-PoshThemes.ps1" })`，之后可以通过`Set-PoshTheme`命令来切换主题。比如`Set-PoshTheme -Name "Solarized"`，就能启用一个深色主题。但是，有些开发者在使用WSL时，会因为终端没有正确配置而出现显示异常。这时候需要检查VS Code的终端设置，确保`terminal.integrated.profiles.windows`里的PowerShell配置项包含了`"colorScheme": "Solarized (Dark)"`，否则PS1变量可能无法正常渲染。如果字体依然显示不正常，可以手动设置字体为`Consolas`或`Cascadia Code`，避免字体不兼容的问题。

四
对于Ubuntu用户来说，终端默认是bash，所以需要配置PS1变量来让终端看起来更舒服。我之前在WSL里装了一个叫`bash-it`的bash主题管理工具，它提供了一些非常好看的主题，比如`agnoster`。配置方法是克隆仓库到`~/.bash-it`，然后`source ~/.bash-it/bash_it.sh`，接着`bash_it theme agnoster`。但这个主题在Windows终端里可能显示不全，或者某些字符无法正常显示。这时候得在`~/.bashrc`里添加一个`PS1`变量，比如`export PS1='\[\e[38;5;123m\]\u@\h:\w\$ '`，这样就能让终端提示符显示成彩色，同时也能兼容Windows终端。不过，有些开发者在使用WSL时，终端宽度不够，导致提示符被截断。这时候可以在VS Code的终端设置里，手动设置`terminal.integrated.width`为900，`terminal.integrated.height`为40，确保终端窗口足够大，不会影响显示效果。

五
VS Code的终端默认会用Windows的console字体，但如果你在WSL里使用，最好用`Cascadia Code`或者`Fira Code`。这些字体在Windows系统里已经安装了，但VS Code有时候会忽略系统字体配置，特别是当你在WSL中使用PowerShell或者bash时。这时候可以手动在`settings.json`里设置`terminal.integrated.fontFamily`为`Cascadia Code`，`terminal.integrated.fontSize`为16。同时，为了确保字体在终端里显示正常，还需要调整终端的渲染方式。比如，在`settings.json`中添加`"terminal.integrated.rendererType": "dom"`，这样终端在WSL下能更好地渲染字体，避免出现锯齿或者模糊的问题。如果你在使用Windows Terminal或命令提示符，也可以通过`terminal.integrated.defaultProfile.windows`来指定默认的终端类型，这样在VS Code中运行终端的时候就能保持一致的样式。

六
颜色主题的配置是整个美化方案中最关键的一环。我见过不少开发者直接使用系统默认的深色主题，但效果并不理想。推荐使用`Solarized Dark`主题，它在Windows终端和WSL中都能很好地显示。配置方法是打开`settings.json`，找到`"terminal.integrated.colorCustomizations"`，然后添加`"background": "#002b36", "foreground": "#839496"`，这样就能让终端背景更暗，文字更亮。但有个问题，如果你在WSL里用了彩色提示符，颜色主题可能会被覆盖。这时候要确保`Solarized Dark`的配置优先级更高，可以在`settings.json`中设置`"terminal.integrated.colorCustomizations": {"default": {"background": "#002b36", "foreground": "#839496"}}`，这样即使你用了PS1变量，颜色也会保持统一。如果你还想要更高级的定制，可以用`Color Theme`插件来管理不同的终端颜色方案，这样在切换不同项目时，终端颜色也能跟着切换。

七
WSL的终端和Windows终端在渲染上存在差异，特别是字体和符号的显示。有些开发者在使用`agnoster`主题时，发现WSL中显示的符号和Windows终端不一样，这是因为WSL2默认只支持基本的终端渲染，不支持powerline符号。这时候可以安装`Powerline`字体家族，然后在终端设置里指定`"terminal.integrated.fontFamily": "Powerline"`, 但要注意，Powerline字体可能在某些系统上安装不完整。为了避免这个问题，可以使用`oh-my-posh`提供的内置字体，它已经包含了所有必要的符号，不需要额外安装。在`oh-my-posh`的配置文件中，可以添加`"font": "Powerline"`, 但这也需要你在系统里安装Powerline字体，否则会报错。我的做法是直接在`~/.bashrc`中配置PS1变量，然后在`settings.json`里指定字体和颜色方案，这样就能兼容所有系统。

八
WSL2中默认的终端字体是Consolas，但如果你想要更好的显示效果，必须换成支持符号的字体。我之前在一台电脑上用了`Cascadia Code`，结果发现某些字符显示不正常。后来才意识到，需要同时安装`Cascadia Code`和`Cascadia Code PL`，也就是带powerline符号的版本。安装方法是去微软官网下载字体包，然后解压到`C:\Windows\Fonts`目录下。安装好后，在VS Code的设置中，找到`terminal.integrated.fontFamily`，指定为`Cascadia Code PL`，同时设置`terminal.integrated.fontSize`为16。这样在WSL中使用PowerShell时，字符可以正常显示，不会出现乱码或者缺失的问题。不过，有些Windows系统可能不支持这种字体，这时候可以用`Fira Code`作为替代方案，效果也很不错。

九
在WSL2里，如果你使用的是Ubuntu，有时候会发现终端显示的颜色不对。这是因为WSL2的终端和Windows终端在颜色支持上有差异。我之前在VS Code中配置了`Solarized Dark`主题，结果在WSL里颜色看起来非常暗，几乎看不清代码。后来才发现，WSL2的终端默认不支持真彩色，所以即使你设置了`"terminal.integrated.profiles.windows": {"Ubuntu": {"colorScheme": "Solarized (Dark)"}}`，实际显示还是会出问题。这时候需要手动设置`"terminal.integrated.colorCustomizations": {"default": {"background": "#002b36", "foreground": "#839496"}}`，并确保`"terminal.integrated.rendererType": "dom"`，这样就能在WSL里实现和Windows终端一致的显示效果。另外，如果你用的是`agnoster`主题，可以在PS1变量中添加`"\[\033[0;33m\]${debian_chroot:+($debian_chroot)}\[\033[0m\] $"`，这样就能让路径和当前用户显示成不同的颜色，提高可读性。

十
在WSL2中，如果你使用的是PowerShell，可以通过`Get-Theme`命令查看可用的主题。我之前在`oh-my-posh`中使用了`Solarized`主题，但发现颜色不够鲜艳，于是又尝试了`Dracula`，效果也不错。设置方法是`Set-PoshTheme -Name "Dracula"`，然后重启终端。不过，有些开发者在设置主题后发现终端还是原样，这时候需要检查`PSModulePath`是否正确配置。在`settings.json`中，添加`"terminal.integrated.env.windows": {"PSModulePath": "$env:PSModulePath;$env:USERPROFILE\\Documents\\WindowsPowerShell"}`，确保`oh-my-posh`的模块路径正确。另外，如果你在Windows Terminal中使用PowerShell，也可以通过`colorScheme`来指定主题，这样终端和VS Code就能保持一致。

十一
使用WSL时，终端的性能也是需要考虑的一个点。如果终端设置过于复杂，比如使用了多个字体和颜色方案，可能会导致终端渲染变慢。我之前在一台配置较低的笔记本上，使用了`agnoster`主题和`Cascadia Code`字体，结果每次打开终端都要等几秒才显示。后来发现，是因为`agnoster`主题的配置文件太长，导致每次启动都重复加载。这时候可以简化配置，只保留必要的部分，比如路径和当前用户信息。另外，WSL2的终端如果使用的是`dom`渲染方式，可能会比`win32`慢一些，尤其是在高分辨率下。我的建议是，如果终端速度不够，可以尝试切换回`win32`渲染方式，这样虽然显示效果可能不如`dom`，但运行速度会快很多。

十二
在VS Code中，如果你要美化WSL终端，还需要考虑字体的渲染方式。我之前用过`monospace`字体，结果发现终端在高分辨率下显示很模糊。后来换成`Fira Code`，再调整`terminal.integrated.fontSize`为15，效果明显提升。但有些Windows系统可能不支持`Fira Code`，这时候可以考虑使用`Consolas`或者`Courier New`，虽然它们可能没有`Cascadia Code`那样现代，但至少能保证终端显示清晰。另外，如果你在使用`oh-my-posh`，可以设置字体为`Cascadia Code PL`，这样就能在终端里显示powerline符号，让提示符看起来更美观。我见过不少开发者在设置字体后，终端依然模糊，后来才发现是因为没有调整`terminal.integrated.lineHeight`，这个参数控制着行高，如果设置不当，字体看起来就会很怪异。

十三
WSL2的终端和Windows终端在Windows 11上可以无缝切换，但有时候颜色和字体的显示会有偏差。我之前在Windows Terminal里设置了`Solarized (Dark)`主题，结果在VS Code里看到的终端颜色和Windows上的一样，但字体显示效果却差很多。后来发现，VS Code的终端默认使用系统字体，而Windows Terminal使用的是`Consolas`，所以需要手动在VS Code中指定字体为`Consolas`。配置方法是打开`settings.json`，添加`"terminal.integrated.fontFamily": "Consolas"`，这样就能确保字体显示一致。不过，有些开发者在设置字体后，发现终端显得很小，这时候可以调整`"terminal.integrated.fontSize": 16`，让字体更大一些，提高可读性。另外，设置`"terminal.integrated.lineHeight": 1.2`，可以让终端显示更舒服。

十四
在使用WSL2时，如果你希望终端显示与Windows一致，可以使用`setw`命令来设置终端宽度。我之前在使用`agnoster`主题时，发现路径显示太长，导致终端被截断。于是用`setw 900`来设置终端宽度，这样就能显示完整的路径。不过，这种方法只适用于bash环境，如果你用的是PowerShell，可能需要手动调整`PS1`变量中的路径显示长度。另外，有些开发者在使用WSL2时，会发现终端的行高和字体比例不协调，这时候可以调整`"terminal.integrated.lineHeight": 1.2`，让终端看起来更自然。同时，设置`"terminal.integrated.cursorBlinking": false`，可以让光标更静默，减少视觉干扰。

十五
VS Code的终端配置不仅仅是字体和颜色的问题，还包括一些高级功能，比如符号显示和远程连接的适配。我之前在使用`oh-my-posh`时，发现符号显示不全，后来才发现是因为`oh-my-posh`默认使用的是`Powerline`字体，而系统里没有安装。这时候需要手动下载并安装`Powerline`字体，然后在`settings.json`里设置`"terminal.integrated.fontFamily": "Powerline"`，这样就能显示完整的符号。如果是远程连接到WSL，比如通过SSH，终端的显示效果可能也会打折扣，这时候可以考虑使用`tmux`或者`screen`来管理终端，这样能更好地控制显示效果。另外，使用`oh-my-posh`时，可以添加一些自定义的提示符，比如时间、项目名称等，让终端看起来更专业。