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

发布于：2025-07-01 ⋅ 阅读:(17) ⋅ 点赞:(0)

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

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

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

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

第一部分：基础环境 (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 是这个技术栈的绝佳选择。

  1. 安装 VS Code:

    • macOS: brew install --cask visual-studio-code
    • Windows: choco install vscode -y

  2. 安装 Shell 命令:

    • 打开 VS Code，按下 Cmd+Shift+P (macOS) 或 Ctrl+Shift+P (Windows)，输入 Shell Command，选择 Install 'code' command in PATH。这样你就可以在终端里用 code . 来打开当前文件夹。

  3. 必备插件 (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 后端的项目。

  1. 创建项目文件夹

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

  2. 初始化前端 (Next.js)

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

  3. 初始化后端 (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

  4. 使用 VS Code 打开整个项目

    • 回到项目根目录 (my-fullstack-app)。
    • 运行 code .
    • VS Code 会自动识别你的 Python 环境（右下角会提示）和 Node 环境。

  5. 配置 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"

总结：你的稳定开发环境

  • 终端: iTerm2 (macOS) / Windows Terminal (Win)
  • 包管理器: Homebrew (macOS) / Chocolatey (Win)
  • 版本控制: Git
  • Node 管理: nvm (安装 LTS 版本)
  • JS 包管理: pnpm (推荐) 或 npm
  • Python 管理: pyenv + venv (项目隔离)
  • 编辑器: VS Code + 推荐插件

这套环境搭建好之后，无论是开发个人项目还是参与团队协作，都能提供非常稳定和高效的体验。恭喜你，可以开始愉快地编码了！

网站公告

今日签到

点亮在社区的每一天
去签到

热门文章

最新发布