2、开发环境搭建:Node.js安装、npm/yarn配置、Git版本控制、VS Code插件推荐
说实话,搭建开发环境这件事,看着简单,但坑是真不少。我见过太多新手卡在这一步,装了半天跑不起来,最后发现是版本不对或者路径有中文。咱们今天就把这事一次搞定。
2.1 Node.js 安装——选对版本很重要
Node.js 是整个 Electron 应用的基础。没有它,后面什么都干不了。
去哪下载?
直接去官网 nodejs.org。你会看到两个版本:LTS 和 Current。
- LTS(长期支持版):稳定,推荐。我一般都用这个。
- Current(最新版):尝鲜用,但可能有兼容问题。
注意:千万别装 Current 版本做项目。我曾经图新鲜装了 v18 的早期版本,结果有个 npm 包死活装不上,查了半天才发现是 Node 版本不兼容。白白浪费了两个小时。
安装步骤(Windows 为例):
- 下载
.msi安装包 - 双击安装,一路 Next
- 安装路径不要有中文!不要有空格!
- 安装完成后,打开命令行,输入:
node -v
npm -v
能看到版本号,就说明装好了。
小技巧:我习惯用
nvm(Node Version Manager)来管理多个 Node 版本。这样不同项目可以用不同版本,切换起来很方便。比如你同时维护两个项目,一个用 v16,一个用 v18,nvm 就能搞定。
2.2 npm/yarn 配置——别让网络拖后腿
Node.js 装好了,接下来就是包管理器。npm 是自带的,yarn 是 Facebook 出的替代品。我个人更推荐 yarn,因为它的安装速度更快,锁定文件也更可靠。
安装 yarn:
npm install -g yarn
装完之后,验证一下:
yarn --version
配置镜像源——这是关键一步。
你想想看,npm 默认的源在国外,下载速度慢得让人抓狂。我刚开始做项目时,装个依赖要等十几分钟,还经常失败。后来换了淘宝镜像,几秒钟就搞定。
配置方式:
# npm 配置
npm config set registry https://registry.npmmirror.com
# yarn 配置
yarn config set registry https://registry.npmmirror.com
避坑指南:我曾经遇到过一个问题——配置了镜像源之后,有些私有包反而装不上了。因为镜像源只同步了公开包,私有包还是得走原始源。解决办法是:用
.npmrc 文件单独配置,比如:
registry=https://registry.npmmirror.com
@mycompany:registry=https://npm.mycompany.com
2.3 Git 版本控制——你的后悔药
Git 这东西,说白了就是给你的代码拍快照。每改一个功能,拍一张。改坏了?退回去就行。
安装 Git:
- Windows:下载
Git for Windows,安装时选「Use Git from the command line」 - Mac:用 Homebrew 装
brew install git - Linux:
sudo apt install git
基本配置——装完先做这两件事:
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
为什么?因为每次提交代码,Git 都会记录是谁提交的。不配的话,提交记录里会显示「unknown」,看着很不专业。
初始化项目仓库:
cd 你的项目文件夹
git init
git add .
git commit -m "第一次提交"
我的习惯:每次提交前,我都会先跑一遍
git status,看看改了哪些文件。这样能避免不小心把不该提交的文件(比如 node_modules)也加进去。对了,记得在项目根目录创建 .gitignore 文件,把 node_modules/、.env 这些写进去。
2.4 VS Code 插件推荐——让开发更顺手
VS Code 本身只是个编辑器,装上插件才算是开发利器。下面这几个是我做 Electron 项目必装的:
| 插件名称 | 作用 | 推荐理由 |
|---|---|---|
| ESLint | 代码规范检查 | 自动帮你揪出语法错误和风格问题 |
| Prettier | 代码格式化 | 保存文件时自动排版,团队协作必备 |
| GitLens | Git 增强工具 | 能看到每行代码是谁写的、什么时候写的 |
| Debugger for Chrome | 调试 Electron 渲染进程 | 可以直接在 VS Code 里打断点调试 |
| Path Intellisense | 路径自动补全 | 引入文件时不用手敲路径,省心 |
安装方法:打开 VS Code,按 Ctrl+Shift+X(Mac 是 Cmd+Shift+X),搜索插件名,点安装就行。
避坑指南:插件不是越多越好。我见过有人装了四五十个插件,结果 VS Code 启动要半分钟,写代码还卡。我的建议是:装最核心的几个,等真正需要了再加。比如你还没用到 TypeScript,就别装 TypeScript 相关的插件。
2.5 验证环境——跑一个 Hello World
环境搭好了,咱们验证一下能不能用。新建一个 test.js 文件,写一行代码:
console.log("Hello, Electron!");
然后在终端里运行:
node test.js
如果看到输出 Hello, Electron!,恭喜你,环境搭建成功了。
最后说一句:搭建环境这件事,一次配好,后面就省心了。别嫌麻烦,花点时间把每一步都走通。我刚开始学的时候,就是图快,结果后面三天两头出问题,反而更浪费时间。嗯,稳一点,没错。