From dbbf1efc7849e2c62b9a81f782095a683ebe2867 Mon Sep 17 00:00:00 2001 From: thzxx Date: Mon, 18 May 2026 13:02:39 +0800 Subject: [PATCH] =?UTF-8?q?DEVSETUP.md:=20=E7=A7=BB=E9=99=A4=E7=A1=AC?= =?UTF-8?q?=E7=BC=96=E7=A0=81=E8=B7=AF=E5=BE=84=EF=BC=8C=E9=80=9A=E7=94=A8?= =?UTF-8?q?=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- DEVSETUP.md | 22 +++++++--------------- 1 file changed, 7 insertions(+), 15 deletions(-) diff --git a/DEVSETUP.md b/DEVSETUP.md index 73c93b5..efe3898 100644 --- a/DEVSETUP.md +++ b/DEVSETUP.md @@ -1,6 +1,6 @@ # Electron 项目开发环境完整配置指南 -以下涵盖从 Node 版本管理、镜像源配置到 electron-builder 打包的全流程,基于你当前 `C:\Workspace\MarkLite` 项目的实际情况。 +以下涵盖从 Node 版本管理、镜像源配置到 electron-builder 打包的全流程。 ## 一、Node 版本管理(nvm) @@ -19,17 +19,11 @@ nvm alias default 18 ## 二、配置镜像源 -你的 npm 版本是 v11.12.1,已经不支持 `npm config set ELECTRON_MIRROR` 这种自定义键名的方式,必须直接编辑 `.npmrc` 文件。 +npm v9+ 已不支持 `npm config set` 设置自定义键名,必须直接编辑 `.npmrc` 文件。 ### 推荐方式:项目级 .npmrc(仅对当前项目生效) -在项目根目录 `C:\Workspace\MarkLite>` 执行: - -```bash -notepad .npmrc -``` - -写入以下内容并保存: +在项目根目录下创建或编辑 `.npmrc` 文件,写入以下内容: ``` registry=https://registry.npmmirror.com @@ -37,7 +31,7 @@ ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/ ``` -如果你想让所有项目都生效,可以编辑全局 `.npmrc`,路径位于 `C:\Users\Administrator.USER-20250226EX\.npmrc`,内容同上。 +如果想让所有项目都生效,编辑全局 `.npmrc`(可通过 `npm config get userconfig` 查看路径),内容同上。 ## 三、配置文件说明 @@ -62,7 +56,7 @@ npm install npm run build ``` -构建成功后,安装包会生成在 `dist\` 目录下。 +构建成功后,安装包会生成在 `dist/` 目录下。 ## 五、一次性完整操作步骤总结 @@ -70,9 +64,7 @@ npm run build # ① 确保 Node 版本正确 nvm use 18 -# ② 编辑项目 .npmrc -notepad C:\Workspace\MarkLite\.npmrc -# 粘贴以下三行后保存: +# ② 在项目根目录创建 .npmrc,写入: # registry=https://registry.npmmirror.com # ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ # ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/ @@ -85,6 +77,6 @@ npm run build ## 六、常见问题排查 -- **`ELECTRON_MIRROR is not a valid npm option`**:说明 npm 版本太新,禁止用 `npm config set` 设置自定义键,改用编辑 `.npmrc` 文件解决。 +- **`ELECTRON_MIRROR is not a valid npm option`**:npm 版本太新,禁止用 `npm config set` 设置自定义键,改用编辑 `.npmrc` 文件解决。 - **下载 Electron 还是走 GitHub**:检查 `.npmrc` 文件名是否正确(不要写成 `.npmrc.txt`),以及是否重新打开了终端。 - **nvm 切换版本后 node 没变**:确保以管理员身份运行终端,且 nvm 安装路径没有中文或空格。