很多前端开发问题,在公网环境里并不明显:插件缺了就在线装,文档打不开就切个网络,依赖丢了就重新 npm install。但到了内网环境,事情会立刻变得不一样。
我这次遇到的真实问题就很直接:内网装不了软件。VS Code 扩展市场不能访问,很多插件装不上,项目初始化之后的开发体验也会大幅下降。所以我最后没有再纠结“进去以后再补”,而是先把常用插件的下载链接整理出来,保证带进内网后至少能把开发环境快速搭起来。
这篇文章就把这套思路整理一下,适合有类似环境限制的人参考。
先分清:插件和依赖不是同一件事
在内网环境里,最容易混淆的就是 VS Code 插件和项目依赖。
- 插件解决的是编辑体验,比如语法高亮、路径补全、代码片段、类型提示。
node_modules解决的是项目能不能真正跑起来。
只把插件带进内网,项目依然可能无法启动;只把依赖带进去,没有语言支持和补全,开发效率又会非常差。所以更稳的顺序应该是:先准备插件下载链接,再准备项目依赖包。
我优先带进去的 Vue 核心插件
如果是 Vue 3 项目,我通常会先准备这几类最核心的插件:
- Vue – Official(Volar 核心)
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/Vue/vsextensions/volar/latest/vspackage - TypeScript Vue Plugin
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/Vue/vsextensions/vscode-typescript-vue-plugin/latest/vspackage - Vue VSCode Snippets
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/sdras/vsextensions/vue-vscode-snippets/latest/vspackage
这三类插件优先级最高,因为它们直接决定了 Vue 单文件组件能不能正常识别、补全和提示。没有这部分,后面再装其他插件,体验也只是“看起来热闹”,但核心问题没有解决。
补齐开发效率常用插件
如果项目里还会频繁写样式、处理路径或调试错误,我通常还会补几类效率型插件:
- Vite
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/antfu/vsextensions/vite/latest/vspackage - Iconify IntelliSense
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/antfu/vsextensions/iconify/latest/vspackage - IntelliSense for CSS class names
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/Zignd/vsextensions/html-css-class-completion/latest/vspackage - CSS Peek
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/pranaygp/vsextensions/vscode-css-peek/latest/vspackage - Stylelint
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/stylelint/vsextensions/vscode-stylelint/latest/vspackage - Path Intellisense
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ionutvmi/vsextensions/path-intellisense/latest/vspackage - Auto Close Tag
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/formulahendry/vsextensions/auto-close-tag/latest/vspackage - Error Lens
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/usernamehw/vsextensions/errorlens/latest/vspackage - GitLens
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/eamodio/vsextensions/gitlens/latest/vspackage - Chinese Language Pack
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/MS-CEUX/vsextensions/vscode-language-pack-zh-hans/latest/vspackage
这些插件不是每个项目都必须,但在内网里很有价值。原因很简单:一旦无法随时查资料,编辑器本地提供的补全、提示和定位能力就会变得更重要。
下载之后,别忘了改成 .vsix
通过这些链接拿到的文件,经常不是直接可安装的 .vsix,而是 vspackage。带进内网前,要先统一改后缀名,再用 VS Code 的 Install from VSIX 安装。
如果文件很多,直接批量改名会更省事。比如在 Windows 上可以放一个简单的批处理脚本:
@echo off
rename *vspackage *.vsix
echo 批量重命名完成!
pause
真正决定项目能不能跑起来的,还是 node_modules
插件准备齐了,只能说明编辑器体验差不多可用了,但这不等于项目就能跑。
如果内网机器没有对应项目的 node_modules,那就算插件全装好了,也只是“能看不能跑”。所以更稳的办法是:在联网环境里先完整执行一次 npm install,确认依赖都下载成功,再把项目目录和 node_modules 一起打包带进内网。
这个包会大一点,但比进内网后再一个个补依赖、补插件、补工具链要省时间得多。
结语
内网环境做开发,最大的坑往往不是技术本身,而是默认的外网便利突然全部失效。与其到了现场再临时排障,不如提前把关键软件下载链接、插件包和项目依赖准备好。
如果你也碰到“内网装不了软件”这类情况,可以先照着这个思路整理一份自己的工具清单。等真正进了环境,你会发现这种前置准备比任何临时补救都更有效。