第2章开发环境搭建

第二章开发环境搭建：工欲善其事，必先利其器

做EDA前端图形化开发，环境搭建是第一道坎。说实话，我见过太多人卡在这一步——不是Python版本冲突，就是Node.js死活装不上。我自己早期也踩过不少坑，今天就把这些经验一次性说清楚。

本章核心脉络：操作系统选择 → Python环境配置 → Node.js与npm安装 → Git版本控制。这四个环节环环相扣，缺一不可。

2.1 操作系统选择：Linux还是Windows？

这个问题我当年纠结了很久。说实话，没有绝对的对错，关键看你的项目需求。

我个人推荐Linux（Ubuntu 22.04 LTS）。为什么？因为EDA工具链对Linux的支持最成熟。我在项目中遇到过好几次，同样的Python脚本在Windows上跑得好好的，一上生产环境就报路径错误——全是反斜杠和正斜杠的锅。

我的建议：

主力开发机用 Ubuntu 22.04 LTS 或 Debian 12
如果你离不开Windows，用 WSL2（Windows Subsystem for Linux 2）
别用Mac？其实也可以，但EDA社区对macOS的支持相对弱一些

注意：如果你选择Windows + WSL2，记得把项目文件放在WSL2的文件系统里（比如 /home/yourname/projects），不要放在 /mnt/c/ 下面。我曾经因为这个吃了大亏——文件权限混乱，npm install 动不动就报错。

2.2 Python环境配置

Python是EDA前端开发的核心语言。你想想看，从后端数据处理到前端界面逻辑，几乎都离不开它。

第一步：安装pyenv

别直接用系统自带的Python。为什么？因为系统Python版本太老了，而且你装新包时容易把系统搞崩。我习惯用pyenv来管理多个Python版本。

# 安装依赖
sudo apt update
sudo apt install -y make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

# 安装pyenv
curl https://pyenv.run | bash

# 配置环境变量（加到 ~/.bashrc 或 ~/.zshrc）
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc

# 重启shell后安装Python 3.10
pyenv install 3.10.12
pyenv global 3.10.12

第二步：创建虚拟环境

每个项目都应该有自己的虚拟环境。这就像每个人有自己的工位一样——互不干扰。

# 创建虚拟环境
python -m venv eda_env

# 激活环境
source eda_env/bin/activate  # Linux/Mac
# 或者 eda_env\Scripts\activate  # Windows

# 安装常用包
pip install --upgrade pip
pip install numpy pandas matplotlib
pip install PyQt6  # 或者 PySide6，看你的偏好

避坑指南：我曾经在项目里直接用了系统Python，结果装PyQt6时把系统桌面环境搞崩了。嗯，从那以后我再也不敢偷懒了——虚拟环境是底线。

2.3 Node.js与npm安装

EDA前端图形化界面，说白了就是Web技术 + 桌面壳。Node.js是跑JavaScript服务的，npm是包管理器。这两个缺一不可。

用nvm管理Node版本

我个人强烈推荐用nvm（Node Version Manager）。为什么？因为不同项目可能依赖不同版本的Node，nvm可以让你一键切换。

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

# 重新加载shell配置
source ~/.bashrc

# 安装Node.js LTS版本（推荐18或20）
nvm install 18
nvm use 18
nvm alias default 18

# 验证安装
node --version  # 应该显示 v18.x.x
npm --version   # 应该显示 9.x.x

小技巧：安装完Node后，建议配置npm的镜像源。国内用户你懂的——直接连npm官方源慢得让人抓狂。

npm config set registry https://registry.npmmirror.com

安装Electron（可选但推荐）

如果你打算用Electron做桌面应用，现在就可以装上。

npm install -g electron
# 或者用npx
npx electron --version

2.4 Git版本控制

Git是程序员的后悔药。没有Git的项目，就像没有刹车的车——你敢开吗？

安装Git

# Linux
sudo apt install git

# 验证
git --version  # 建议 2.30+

基础配置

git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"
git config --global core.editor "vim"  # 或者 code --wait 用VS Code

配置SSH密钥

这一步很多人会忽略，但非常重要。用SSH连接GitHub/GitLab，比HTTPS方便太多了。

# 生成SSH密钥
ssh-keygen -t ed25519 -C "你的邮箱@example.com"

# 查看公钥
cat ~/.ssh/id_ed25519.pub

# 把公钥添加到GitHub/GitLab的SSH Keys设置中

注意：我曾经犯过一个低级错误——把私钥也上传到了GitHub。嗯，那天的教训很深刻。记住：私钥永远不要泄露，公钥随便给。

推荐的工作流

对于EDA前端项目，我习惯用这个分支策略：

分支	用途	说明
main	稳定版本	只合并经过测试的代码
develop	日常开发	所有功能分支从这里拉出
feature/xxx	新功能	比如 feature/eda-canvas
fix/xxx	Bug修复	比如 fix/memory-leak

总结一下：环境搭建这件事，看起来琐碎，但每一步都关系到后续的开发效率。我个人花了大概两天时间才把整套环境调顺——包括踩坑和重装。你如果按这个流程走，应该半天就能搞定。

好了，环境搭好了，接下来就可以真正开始写代码了。

公众号:蓝海资料掘金营，微信deep3321