DEVSETUP.md: 移除硬编码路径,通用化
This commit is contained in:
+7
-15
@@ -1,6 +1,6 @@
|
|||||||
# Electron 项目开发环境完整配置指南
|
# Electron 项目开发环境完整配置指南
|
||||||
|
|
||||||
以下涵盖从 Node 版本管理、镜像源配置到 electron-builder 打包的全流程,基于你当前 `C:\Workspace\MarkLite` 项目的实际情况。
|
以下涵盖从 Node 版本管理、镜像源配置到 electron-builder 打包的全流程。
|
||||||
|
|
||||||
## 一、Node 版本管理(nvm)
|
## 一、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(仅对当前项目生效)
|
### 推荐方式:项目级 .npmrc(仅对当前项目生效)
|
||||||
|
|
||||||
在项目根目录 `C:\Workspace\MarkLite>` 执行:
|
在项目根目录下创建或编辑 `.npmrc` 文件,写入以下内容:
|
||||||
|
|
||||||
```bash
|
|
||||||
notepad .npmrc
|
|
||||||
```
|
|
||||||
|
|
||||||
写入以下内容并保存:
|
|
||||||
|
|
||||||
```
|
```
|
||||||
registry=https://registry.npmmirror.com
|
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/
|
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
|
npm run build
|
||||||
```
|
```
|
||||||
|
|
||||||
构建成功后,安装包会生成在 `dist\` 目录下。
|
构建成功后,安装包会生成在 `dist/` 目录下。
|
||||||
|
|
||||||
## 五、一次性完整操作步骤总结
|
## 五、一次性完整操作步骤总结
|
||||||
|
|
||||||
@@ -70,9 +64,7 @@ npm run build
|
|||||||
# ① 确保 Node 版本正确
|
# ① 确保 Node 版本正确
|
||||||
nvm use 18
|
nvm use 18
|
||||||
|
|
||||||
# ② 编辑项目 .npmrc
|
# ② 在项目根目录创建 .npmrc,写入:
|
||||||
notepad C:\Workspace\MarkLite\.npmrc
|
|
||||||
# 粘贴以下三行后保存:
|
|
||||||
# registry=https://registry.npmmirror.com
|
# registry=https://registry.npmmirror.com
|
||||||
# ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
|
# ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
|
||||||
# ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/
|
# 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`),以及是否重新打开了终端。
|
- **下载 Electron 还是走 GitHub**:检查 `.npmrc` 文件名是否正确(不要写成 `.npmrc.txt`),以及是否重新打开了终端。
|
||||||
- **nvm 切换版本后 node 没变**:确保以管理员身份运行终端,且 nvm 安装路径没有中文或空格。
|
- **nvm 切换版本后 node 没变**:确保以管理员身份运行终端,且 nvm 安装路径没有中文或空格。
|
||||||
|
|||||||
Reference in New Issue
Block a user