ByteFisher AI 编程实战（四）：AI编程的编程语言基础

从本篇开始，我们从概念进入实战。AI 编程需要一套基础开发环境，无论你用哪种 AI 编程工具，Python、Node.js、Git 和 VS Code 都是绕不开的基石。

一、为什么需要这些工具

工具	用途	为什么 AI 编程需要它
Python	AI 生态的第一语言	大部分 AI 框架和工具用 Python 编写
Node.js	JavaScript 运行时	前端工程化、CLI 工具的基础环境
Git	版本控制	AI 生成的代码需要版本管理，方便对比和回滚
VS Code	编辑器	插件生态丰富，是 AI 编程工具的天然宿主

这套环境关系紧密：你用 VS Code 写代码，Python 和 Node.js 运行 AI 工具，Git 管理 AI 生成的代码变更。

二、安装 Python

2.1 下载与安装

访问 python.org 下载最新 Python 3.12+ 版本。Windows 安装时务必勾选”Add Python to PATH”。

验证安装：

1 2	python --version # 输出类似：Python 3.12.2

2.2 虚拟环境管理

每个项目使用独立的虚拟环境，避免依赖冲突：

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

# 激活（Windows）
.venv\Scripts\activate

# 激活（macOS/Linux）
source .venv/bin/activate

# 安装 AI 编程常用包
pip install openai langchain chromadb pandas requests

# 导出依赖清单
pip freeze > requirements.txt

为什么需要虚拟环境？ AI 项目通常依赖大量第三方包。不同的项目可能需要不同版本的包（例如 LangChain 常用版本更新频繁），虚拟环境让每个项目互不干扰。

2.3 Poetry 可选

对于更专业的项目管理，推荐使用 Poetry：

pip install poetry
poetry new my-ai-project
cd my-ai-project
poetry add openai langchain

三、安装 Node.js

3.1 下载与安装

访问 nodejs.org 下载 LTS 版本，验证安装：

node --version
# 输出类似：v22.14.0
npm --version
# 输出类似：10.9.2

3.2 npm 常用配置

# 设置镜像源加速（中国大陆）
npm config set registry https://registry.npmmirror.com

# 安装全局工具
npm install -g typescript ts-node nodemon

Node.js 是 Cursor、Claude Code cc-switch 等工具的运行基础，也是前端开发的必备环境。

四、安装和配置 Git

4.1 安装与基本配置

从 git-scm.com 下载安装，配置身份：

git config --global user.name "Your Name"
git config --global user.email "your@email.com"
git config --global init.defaultBranch main
git config --global core.autocrlf true  # Windows 换行符处理

4.2 AI 编程中的 Git 工作流

Git 在 AI 编程中比传统开发更重要——因为你将频繁地接受、审查、回滚 AI 的修改：

AI 生成代码后：
1. git status        → 看 AI 改/创建了哪些文件
2. git diff          → 审查 AI 改了什么内容
3. 手动检查关键逻辑
4. git add -p        → 逐块确认修改（不是一次性全部接受）
5. git commit -m "feat: AI 生成了 XXX 功能"

关键原则：每次 AI 操作后都做一次 commit。这样你可以随时 git revert 回滚到 AI 修改前的状态。

4.3 .gitignore 推荐

# AI 生成工具的临时文件
.cursorrules
.claude.json
*.log

# Python
__pycache__/
.env
.venv/

# Node
node_modules/
dist/

五、配置 VS Code

5.1 基础配置

{
  "editor.fontSize": 14,
  "editor.tabSize": 2,
  "editor.wordWrap": "on",
  "editor.formatOnSave": true,
  "files.autoSave": "onFocusChange",
  "editor.minimap.enabled": false,
  "workbench.colorTheme": "One Dark Pro"
}

5.2 AI 编程必备插件

插件	用途	推荐度
GitHub Copilot	AI 代码补全	五星
Continue	开源 AI 编程助手，支持多模型	五星
GitLens	增强 Git 功能	四星
Prettier	代码格式化	五星
Python	Python 语言支持	五星
C# Dev Kit	C# 开发支持	四星
Tailwind CSS IntelliSense	前端 CSS 智能提示	四星

插件的安装原则：只装你确实需要的。插件越多 VS Code 启动越慢，而且可能互相冲突。

六、验证环境

创建一个测试脚本验证环境是否正常：

import sys, subprocess

print(f"Python: {sys.version}")
result = subprocess.run(["node", "--version"], capture_output=True, text=True)
print(f"Node.js: {result.stdout.strip()}")
result = subprocess.run(["git", "--version"], capture_output=True, text=True)
print(f"Git: {result.stdout.strip()}")
print("开发环境就绪！")

七、各操作系统差异速查

不同操作系统在环境搭建上有一些关键差异：

操作	Windows	macOS	Linux
Python 安装	python.org 下载安装程序	`brew install python`	`apt install python3`
PATH 问题	需勾选 Add to PATH	自动配置	自动配置
包管理器	winget	Homebrew	apt/yum
终端	PowerShell	Terminal (zsh)	Terminal (bash)
路径分隔	`\`	`/`	`/`
Python 命令	`python`	`python3`	`python3`
虚拟环境激活	`.venv\Scripts\activate`	`source .venv/bin/activate`	`source .venv/bin/activate`

7.1 跨平台开发注意事项

在 AI 编程中，跨平台差异是常见的踩坑点：

文件路径：AI 生成的代码中硬编码路径分隔符可能导致跨平台出错。使用 os.path.join() 或 pathlib
换行符：Windows 用 \r\n，macOS/Linux 用 \n。Git 配置 core.autocrlf 处理
权限：脚本文件在 macOS/Linux 需 chmod +x 赋予执行权限
编码：Windows 默认 GBK，AI 生成的代码如果含中文可能乱码。Python 文件头加 # -*- coding: utf-8 -*-

八、常见问题

问题	原因	解决
Python 命令找不到	未添加到 PATH	重新安装，勾选”Add to PATH”或手动添加
pip 安装失败	网络问题	使用镜像源：`pip install -i https://pypi.tuna.tsinghua.edu.cn/simple`
Git 中文乱码	编码设置	`git config --global core.quotepath false`
VS Code 终端不识别命令	PATH 未刷新	重启 VS Code 或手动刷新终端

九、推荐阅读与进阶资源

搭建好环境后，推荐继续学习以下内容：

领域	推荐资源	说明
Python	Python官方教程	掌握基础语法和标准库
Node.js	Node.js 入门指南	了解 CommonJS 和 ESM 模块系统
Git	Pro Git 免费书籍	深入理解 Git 原理和工作流
VS Code	VS Code 官方文档	了解所有快捷键和扩展能力

这些资源和本系列教程后续内容配合使用，效果最佳。

十、AI 编程环境搭建的核心原则

回头看这一篇的内容，总结三个核心原则：

一次搭建，长期受益：环境搭建是最枯燥但回报最高的一次性投入
版本管理是第一道防线：AI 生成的代码不可预测，Git 是你最重要的安全网
用 AI 搭建 AI 环境：遇到安装问题，直接复制报错信息给 AI 工具寻求帮助——这正是本系列要教会你的能力

十一、环境验证清单

搭建完成后逐项检查：

[ ] Python 可运行: python --version
[ ] pip 可安装包: pip install requests
[ ] 虚拟环境可创建并激活
[ ] Node.js 可运行: node --version
[ ] npm 可安装包: npm install express
[ ] Git 已配置: git config --global --list
[ ] Git 可提交: git init && git commit --allow-empty -m "test"
[ ] VS Code 已安装 Copilot 插件
[ ] Copilot 已登录并显示绿色图标
[ ] .gitignore 已配置

本章小结

Python 是 AI 生态的核心语言，务必掌握虚拟环境管理
Node.js 是前端开发和 CLI 工具的基础环境
Git 在 AI 编程中比传统开发更重要——每次 AI 操作后 commit，方便 diff 和回滚
VS Code 搭配 AI 插件是当前最主流的工作环境
环境搭建是一次性投入，后续所有教程都依赖这套环境
遇到安装问题时，先检查网络连接、环境变量、版本兼容性

从下一篇开始，我们将逐一上手主流的 AI 编程工具。首先是 GitHub Copilot。