当前位置：首页 > news >正文

编程新手之环境搭建：node python

news 2025/7/1 14:05:10

好的，没问题！为你新装的机器打造一套稳定、高效、专业的开发环境是一件非常有成就感的事情。

我们将遵循“稳定优先，专业实践”的原则，不追求最新版本，而是选择社区广泛认可的长期支持版（LTS）和最佳实践工具。

整个过程将分为几个部分：

基础环境： 终端、包管理器和 Git，这是所有开发的基石。
Node.js 环境： 使用版本管理器 nvm，专业地管理 Node.js。
Python 环境： 使用版本管理器 pyenv + venv，实现项目间环境的完美隔离。
代码编辑器： VS Code 及其核心插件配置。
整合与工作流： 创建一个示例项目，将所有工具串联起来。

第一部分：基础环境 (The Foundation)

这些是“磨刀不误砍柴工”的工具，强烈建议安装。

1. 终端 (Terminal)

macOS:
- 推荐使用 iTerm2 (https://iterm2.com/) 替代系统自带的终端。它功能更强大，可定制性更高。
- 配合 Oh My Zsh (https://ohmyz.sh/) 会让你的终端更好用也更好看（命令补全、主题、插件等）。
Windows:
- 现在最好的选择是 Windows Terminal。可以从 Microsoft Store 免费安装。它支持多标签、PowerShell、CMD 和 WSL。
- 建议在 Windows Terminal 中将默认 Shell 设置为 PowerShell 7 (而不是系统自带的 PowerShell 5)。
- 同样可以安装 Oh My Posh 来美化和增强 PowerShell。

2. 包管理器 (Package Manager)

它能让你用一行命令安装和管理绝大多数软件，非常方便。

macOS: Homebrew (https://brew.sh/) 是不二之选。

安装命令（在终端中运行）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Windows: Chocolatey (https://chocolatey.org/) 或 winget (Windows 自带)。推荐 Chocolatey，社区更成熟。

安装 Chocolatey (以管理员身份打开 PowerShell)：

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

3. Git (版本控制)

Git 是现代开发的必需品。

macOS:
```
brew install git
```
Windows:
```
choco install git -y
```

安装后，进行全局配置：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱地址"

第二部分：Node.js 环境 (React / Next.js 基础)

核心原则：绝对不要直接从官网下载安装 Node.js！ 我们使用版本管理器 nvm，这样你可以在不同项目中使用不同版本的 Node.js，避免版本冲突。

1. 安装 nvm (Node Version Manager)

macOS / Linux:
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
```
安装后，需要重启终端，或者运行 source ~/.zshrc (或 ~/.bash_profile) 使命令生效。
Windows: Windows 上有类似的工具叫 nvm-windows。
- 从这里下载最新的 nvm-setup.zip 并安装。

2. 使用 nvm 安装 Node.js

我们安装最新的 LTS (长期支持) 版本，这是最稳定推荐的选择。

# 安装最新的 LTS 版本
nvm install --lts# 将这个版本设置为默认版本
nvm alias default lts/*# 查看已安装版本
nvm ls# 使用默认版本
nvm use default

现在，你的 node 和 npm 命令就已经准备好了。可以验证一下：

node -v  # 应该会显示一个 v18.x.x 或 v20.x.x 的版本
npm -v

可选：包管理器 pnpm

npm 是 Node 自带的包管理器，但 pnpm 或 yarn 在速度和磁盘空间管理上更有优势。推荐 pnpm。

npm install -g pnpm

第三部分：Python 环境

核心原则：同样，不要直接使用系统自带的 Python！ 我们使用 pyenv 来管理 Python 版本，并使用 venv 为每个项目创建隔离的虚拟环境。

1. 安装 pyenv

macOS:
```
brew install pyenv
```
安装后，根据提示将初始化脚本添加到你的 shell 配置文件 (.zshrc 或 .bash_profile) 中。通常是：
```
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
```
然后重启终端。
Windows: Windows 上的等价物是 pyenv-win。
- 可以通过 pip 或者 PowerShell 安装，详情参考官方文档。

2. 使用 pyenv 安装 Python

我们安装一个稳定且广泛使用的版本，例如 3.11.x。

# 查看所有可安装的版本
pyenv install --list# 安装指定版本 (这个过程可能需要几分钟)
pyenv install 3.11.6# 将这个版本设置为全局默认版本
pyenv global 3.11.6

验证一下：

python --version  # 应该显示 Python 3.11.6

3. 虚拟环境 (venv)

这是 Python 开发的最佳实践。为每个项目创建一个独立的虚拟环境，以避免包依赖冲突。venv 是 Python 3.3+ 自带的模块，无需另外安装。

使用方法我们将在第五部分的工作流中演示。

第四部分：代码编辑器 (VS Code)

VS Code 是这个技术栈的绝佳选择。

安装 VS Code:
- macOS: brew install --cask visual-studio-code
- Windows: choco install vscode -y
安装 Shell 命令:
- 打开 VS Code，按下 Cmd+Shift+P (macOS) 或 Ctrl+Shift+P (Windows)，输入 Shell Command，选择 Install 'code' command in PATH。这样你就可以在终端里用 code . 来打开当前文件夹。
必备插件 (Extensions):
在 VS Code 的插件市场搜索并安装它们：
- ESLint: JavaScript/TypeScript 代码规范检查。
- Prettier - Code formatter: 统一代码风格，自动格式化。
- Python: Microsoft 官方 Python 插件，提供智能提示、调试、Linting 等。
- Pylance: 由 Microsoft 开发，提供更强大的 Python 语言服务。
- GitLens: 极大地增强了 VS Code 的 Git 功能，能看到每行代码的修改历史。
- Tailwind CSS IntelliSense: 如果你使用 Tailwind CSS，这是必备。
- DotENV: .env 文件语法高亮。

第五部分：整合与工作流 (Putting It All Together)

现在，我们来模拟创建一个同时包含 Next.js 前端和 Python 后端的项目。

创建项目文件夹

mkdir my-fullstack-app
cd my-fullstack-app

初始化前端 (Next.js)
- 确保你在使用正确的 Node 版本：nvm use default
- 使用官方脚手架创建 Next.js 应用（这里我们用 pnpm）：
```
pnpm create next-app@latest ./frontend
```
  - ./frontend 表示在当前目录下的 frontend 文件夹中创建项目。
  - 根据提示进行选择（推荐使用 TypeScript 和 App Router）。

初始化后端 (Python)

在项目根目录创建后端文件夹：
```
mkdir backend
cd backend
```

设置项目级 Python 版本 (可选但推荐):

pyenv local 3.11.6  # 这会创建一个 .python-version 文件

创建并激活虚拟环境:
```
# 创建一个名为 .venv 的虚拟环境
python -m venv .venv# 激活虚拟环境
# macOS/Linux:
source .venv/bin/activate
# Windows:
.\.venv\Scripts\activate
```
激活后，你会看到终端提示符前面多了 (.venv) 的字样。这表示你现在安装的任何 Python 包都只属于这个项目。

安装依赖:

pip install flask # 举例，安装一个 web 框架
pip install flask-cors# 将依赖项冻结到 requirements.txt 文件中，方便他人协作
pip freeze > requirements.txt

使用 VS Code 打开整个项目
- 回到项目根目录 (my-fullstack-app)。
- 运行 code .
- VS Code 会自动识别你的 Python 环境（右下角会提示）和 Node 环境。
配置 Git
- 在项目根目录初始化 Git 仓库：
```
git init
```
- 创建一个 .gitignore 文件，忽略不需要版本控制的文件（例如 node_modules, .venv, .next, .DS_Store 等）。GitHub 上有很好的 Node 和 Python 模板。
- 添加所有文件并进行第一次提交：
```
git add .
git commit -m "Initial commit: setup frontend and backend structure"
```