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 安装路径没有中文或空格。