DEVSETUP.md: 移除硬编码路径,通用化
This commit is contained in:
+7
-15
@@ -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 安装路径没有中文或空格。
|
||||
|
||||
Reference in New Issue
Block a user