新手第一次用 AI 写代码:环境搭建、提问方法和常用命令全流程指南
AI编程 新手入门指南|附完整命令
随着大模型技术快速发展,AI 编程已经从“未来趋势”变成了很多开发者、产品经理、运营人员甚至学生都可以直接使用的生产力工具。过去写代码需要从语法、框架、工程结构一点点学起,而现在你可以借助 AI 快速生成代码、解释报错、重构项目、编写测试、生成文档,甚至搭建一个完整的应用原型。
但需要注意的是:AI 编程并不是“完全不用学编程”。它更像是一位随时在线的编程助手,可以帮你提高效率、降低入门门槛,但你仍然需要理解基本概念、会运行命令、能判断代码是否正确。本文将从新手角度出发,带你了解 AI 编程的学习路线、常用工具、开发环境搭建、完整命令示例,以及如何正确向 AI 提问。
一、什么是 AI 编程?
AI 编程,简单来说,就是利用人工智能工具辅助软件开发。它可以帮助你完成以下任务:
- 根据需求生成代码
- 解释一段看不懂的代码
- 查找并修复 Bug
- 将代码从一种语言转换成另一种语言
- 自动生成单元测试
- 优化代码结构和性能
- 编写项目 README 文档
- 生成接口文档、数据库设计、前端页面
- 辅助搭建完整项目
例如,你可以对 AI 说:
请用 Python 写一个爬取网页标题的脚本,并解释每一行代码。
或者:
我有一个 React 项目,运行时报错
Cannot read properties of undefined,请帮我分析原因。
AI 会根据你的描述生成对应的代码或解决方案。
二、新手学习 AI 编程需要掌握什么?
很多人以为使用 AI 编程就不用学基础了,这是一个误区。AI 可以帮你写代码,但你至少需要掌握以下能力:
1. 基础命令行能力
你需要知道如何打开终端、进入文件夹、执行安装命令、启动项目。
常见命令包括:
pwd
ls
cd
mkdir
touch
rm
cp
mv
Windows 用户可以使用 PowerShell,macOS 和 Linux 用户可以使用 Terminal。
2. 至少了解一门编程语言
对于新手来说,推荐从以下两种语言入门:
| 语言 | 适合方向 | 推荐原因 |
|---|---|---|
| Python | 自动化、数据分析、AI 应用、脚本工具 | 语法简单,生态丰富 |
| JavaScript | 前端网页、全栈开发、小程序、Node.js | 应用范围广,适合做可视化项目 |
如果你完全没有基础,建议先学 Python;如果你想做网站或前端页面,可以学习 JavaScript。
3. 会使用代码编辑器
推荐使用 Visual Studio Code,简称 VS Code。它免费、轻量、插件丰富,非常适合新手。
常用插件包括:
- Chinese Language Pack:中文语言包
- Python:Python 开发支持
- ESLint:JavaScript 代码检查
- Prettier:代码格式化
- GitHub Copilot:AI 编程辅助
- Codeium:AI 代码补全工具
- Continue:开源 AI 编程助手插件
4. 理解项目结构
一个项目通常不只是一个代码文件,而是由多个目录和配置文件组成。例如:
my-project/
├── src/
│ └── main.py
├── README.md
├── requirements.txt
└── .gitignore
你需要理解每个文件的大致作用:
src/:存放源代码README.md:项目说明文档requirements.txt:Python 依赖列表.gitignore:告诉 Git 哪些文件不需要提交
三、AI 编程常用工具推荐
1. ChatGPT
ChatGPT 适合:
- 生成代码
- 解释代码
- 规划项目
- 设计接口
- 修复报错
- 编写技术文档
- 辅助学习编程概念
使用技巧是:不要只问一句“帮我写个程序”,而要提供清晰背景、目标、技术栈和限制条件。
2. GitHub Copilot
GitHub Copilot 可以在编辑器中自动补全代码。你输入函数名、注释或部分代码,它会预测并生成后续代码。
适合已经开始写代码的人使用。
3. Cursor
Cursor 是一款面向 AI 编程的编辑器,基于 VS Code 修改而来。它的特点是可以直接读取整个项目上下文,适合进行项目级别的代码修改。
常见使用场景:
- 让 AI 理解整个项目
- 批量修改代码
- 自动修复错误
- 生成页面或组件
- 重构旧项目
4. Continue
Continue 是 VS Code 中常用的开源 AI 编程插件,可以连接不同的大模型服务,用于代码问答、生成和修改。
5. 通义灵码、豆包 MarsCode 等国产工具
如果你更习惯中文环境,也可以使用国内的 AI 编程工具。这些工具通常对中文提示词支持较好,适合初学者使用。
四、开发环境搭建:从零开始
下面分别介绍 Python 和 JavaScript 两套常见环境。
第一部分:Python AI 编程入门
1. 检查是否安装 Python
打开终端,输入:
python --version
如果没有反应,可以尝试:
python3 --version
正常情况下会看到类似输出:
Python 3.12.2
如果没有安装,请到 Python 官网下载安装:
https://www.python.org/
安装时 Windows 用户务必勾选:
Add Python to PATH
2. 创建项目目录
mkdir ai-python-demo
cd ai-python-demo
3. 创建虚拟环境
虚拟环境可以让每个项目拥有独立的依赖,避免不同项目之间互相影响。
Windows:
python -m venv venv
macOS / Linux:
python3 -m venv venv
4. 激活虚拟环境
Windows PowerShell:
.\venv\Scripts\Activate.ps1
Windows CMD:
venv\Scripts\activate
macOS / Linux:
source venv/bin/activate
激活后,你会看到命令行前面多出类似:
(venv)
5. 创建 Python 文件
touch main.py
如果你是 Windows,并且 touch 命令不可用,可以使用:
echo. > main.py
6. 编写第一个 AI 辅助程序
你可以让 AI 生成一个简单的命令行计算器:
提示词示例:
请用 Python 写一个命令行计算器,支持加减乘除。
要求:
1. 使用函数封装;
2. 用户可以连续输入;
3. 输入 q 退出;
4. 对除数为 0 的情况进行处理;
5. 给出完整代码,并解释每一部分。
AI 可能生成如下代码:
def add(a, b):
return a + b
def subtract(a, b):
return a - b
def multiply(a, b):
return a * b
def divide(a, b):
if b == 0:
return "错误:除数不能为 0"
return a / b
def calculator():
print("欢迎使用 Python 命令行计算器")
print("支持操作:+、-、*、/")
print("输入 q 退出程序")
while True:
user_input = input("请输入表达式,例如 1 + 2:")
if user_input.lower() == "q":
print("程序已退出")
break
try:
parts = user_input.split()
if len(parts) != 3:
print("输入格式错误,请使用:数字 运算符 数字")
continue
num1 = float(parts[0])
operator = parts[1]
num2 = float(parts[2])
if operator == "+":
result = add(num1, num2)
elif operator == "-":
result = subtract(num1, num2)
elif operator == "*":
result = multiply(num1, num2)
elif operator == "/":
result = divide(num1, num2)
else:
result = "不支持的运算符"
print("计算结果:", result)
except ValueError:
print("请输入有效数字")
if __name__ == "__main__":
calculator()
运行命令:
python main.py
macOS / Linux 如果默认 Python 版本不对,可以使用:
python3 main.py
7. 安装第三方库
例如,你想让 AI 帮你写一个天气查询工具,可能需要使用 requests 库。
安装命令:
pip install requests
如果使用 Python3:
pip3 install requests
查看已安装依赖:
pip list
导出依赖:
pip freeze > requirements.txt
以后别人拿到项目后,可以使用:
pip install -r requirements.txt
8. Python 项目常用完整命令汇总
# 创建项目
mkdir ai-python-demo
cd ai-python-demo
# 创建虚拟环境
python -m venv venv
# 激活虚拟环境:Windows PowerShell
.\venv\Scripts\Activate.ps1
# 激活虚拟环境:macOS / Linux
source venv/bin/activate
# 创建文件
touch main.py
# 安装依赖
pip install requests
# 查看依赖
pip list
# 导出依赖
pip freeze > requirements.txt
# 运行项目
python main.py
# 退出虚拟环境
deactivate
第二部分:JavaScript / Node.js AI 编程入门
如果你想做网页、小工具、前端项目、接口服务,那么 JavaScript 是非常重要的选择。
1. 检查 Node.js 是否安装
输入:
node -v
再输入:
npm -v
如果输出类似:
v20.11.1
10.2.4
说明安装成功。
如果没有安装,请访问:
https://nodejs.org/
建议安装 LTS 长期支持版本。
2. 创建 Node.js 项目
mkdir ai-node-demo
cd ai-node-demo
npm init -y
执行后会生成:
package.json
这是 Node.js 项目的配置文件。
3. 创建入口文件
touch index.js
Windows 可使用:
echo. > index.js
4. 编写第一个 Node.js 程序
可以向 AI 提问:
请用 Node.js 写一个命令行待办事项程序。
要求:
1. 可以添加任务;
2. 可以查看任务列表;
3. 可以标记任务完成;
4. 使用数组保存数据;
5. 给出完整代码和运行方式。
示例代码:
const readline = require("readline");
const rl = readline.createInterface({
input: process.stdin,
output: process.stdout,
});
let todos = [];
function showMenu() {
console.log("\n待办事项程序");
console.log("1. 添加任务");
console.log("2. 查看任务");
console.log("3. 完成任务");
console.log("4. 退出");
}
function askQuestion() {
showMenu();
rl.question("请选择操作:", function (answer) {
if (answer === "1") {
rl.question("请输入任务内容:", function (task) {
todos.push({
text: task,
done: false,
});
console.log("任务已添加");
askQuestion();
});
} else if (answer === "2") {
if (todos.length === 0) {
console.log("暂无任务");
} else {
todos.forEach((todo, index) => {
console.log(
`${index + 1}. [${todo.done ? "x" : " "}] ${todo.text}`
);
});
}
askQuestion();
} else if (answer === "3") {
rl.question("请输入要完成的任务编号:", function (num) {
const index = Number(num) - 1;
if (todos[index]) {
todos[index].done = true;
console.log("任务已完成");
} else {
console.log("任务不存在");
}
askQuestion();
});
} else if (answer === "4") {
console.log("程序已退出");
rl.close();
} else {
console.log("无效选择");
askQuestion();
}
});
}
askQuestion();
运行命令:
node index.js
5. 使用 npm 安装依赖
例如安装 axios:
npm install axios
安装开发依赖:
npm install nodemon --save-dev
启动自动重启开发模式:
npx nodemon index.js
6. 修改 package.json 启动脚本
打开 package.json,修改:
{
"scripts": {
"start": "node index.js",
"dev": "nodemon index.js"
}
}
然后可以使用:
npm run start
或者:
npm run dev
7. Node.js 项目常用完整命令汇总
# 检查版本
node -v
npm -v
# 创建项目
mkdir ai-node-demo
cd ai-node-demo
# 初始化项目
npm init -y
# 创建入口文件
touch index.js
# 安装依赖
npm install axios
# 安装开发依赖
npm install nodemon --save-dev
# 运行文件
node index.js
# 使用 nodemon 运行
npx nodemon index.js
# 使用 npm 脚本运行
npm run start
npm run dev
# 查看已安装包
npm list
# 卸载依赖
npm uninstall axios
第三部分:用 AI 编程的正确提问方式
AI 编程效果好不好,关键在于你的提示词是否清楚。新手常见问题是描述太模糊,例如:
帮我写个网站。
这个问题太宽泛,AI 不知道你要什么类型的网站、用什么技术、有哪些页面、是否需要数据库、是否要登录功能。
更好的提问方式是:
请帮我用 HTML、CSS、JavaScript 写一个个人作品集网站。
要求:
1. 包含首页、关于我、项目展示、联系方式四个区域;
2. 页面风格简洁,适合程序员;
3. 使用响应式布局,手机和电脑都能正常显示;
4. 不使用任何框架;
5. 给出完整代码,并说明每个文件如何保存和运行。
高质量提示词模板
你可以使用下面这个通用模板:
你是一名资深软件工程师,请帮我完成一个编程任务。
【项目目标】
我要做一个:
【技术栈】
使用:
【功能需求】
1.
2.
3.
【限制条件】
1.
2.
【输出要求】
1. 给出完整代码;
2. 说明项目目录结构;
3. 给出运行命令;
4. 解释关键代码;
5. 如果有依赖,请给出安装命令;
6. 如果可能出错,请列出常见错误和解决方法。
示例:
你是一名资深 Python 工程师,请帮我写一个批量重命名图片的脚本。
【项目目标】
将某个文件夹下的 jpg 和 png 图片按顺序重命名为 image_001、image_002。
【技术栈】
Python 3。
【功能需求】
1. 用户输入文件夹路径;
2. 自动识别 jpg、jpeg、png 文件;
3. 按文件名排序;
4. 重命名时保留原扩展名;
5. 避免文件名冲突。
【输出要求】
1. 给出完整代码;
2. 给出运行命令;
3. 解释关键逻辑;
4. 提醒可能的风险。
第四部分:AI 编程的典型工作流
1. 先让 AI 帮你拆解需求
不要一上来就让 AI 写完整项目,而是先问:
我想开发一个记账 App,请帮我拆解功能模块、页面结构、数据表设计和开发步骤。
这样可以先获得整体方案。
2. 再让 AI 生成最小可运行版本
例如:
请先帮我实现一个最小可运行版本,只包含添加账单和查看账单列表,不需要登录,不需要后端,数据先保存在浏览器 localStorage 中。
这叫 MVP,即最小可行产品。新手一定要从小功能开始,不要一开始就做复杂系统。
3. 运行代码并复制报错给 AI
当代码运行失败时,不要只说“报错了”,而要提供完整信息:
我运行 npm run dev 时出现以下错误:
复制完整报错内容……
我的项目结构是:
复制项目结构……
请帮我分析原因,并给出修改后的完整代码。
AI 需要足够上下文才能准确定位问题。
4. 让 AI 解释代码
不要只复制代码运行,而要继续追问:
请逐行解释这段代码,尤其说明每个函数的作用。
或者:
请用适合编程新手的方式解释这段代码,并举一个运行示例。
这样你才能真正提升能力。
5. 让 AI 帮你优化和测试
当功能能跑起来后,可以继续问:
请帮我检查这段代码有哪些问题,包括可读性、异常处理、安全性和性能。
也可以问:
请为这段代码编写单元测试,并告诉我如何运行测试。
第五部分:Git 版本管理入门
AI 编程很容易频繁修改代码,所以一定要学会 Git。Git 可以帮你保存历史版本,防止改坏项目后无法恢复。
1. 检查 Git 是否安装
git --version
如果没有安装,访问:
https://git-scm.com/
2. 初始化仓库
git init
3. 查看文件状态
git status
4. 添加文件到暂存区
git add .
5. 提交代码
git commit -m "初始化项目"
6. 查看提交历史
git log
简洁查看:
git log --oneline
7. 创建 .gitignore 文件
Python 项目常见 .gitignore:
venv/
__pycache__/
*.pyc
.env
Node.js 项目常见 .gitignore:
node_modules/
.env
dist/
8. Git 常用完整命令汇总
# 检查 Git
git --version
# 初始化仓库
git init
# 查看状态
git status
# 添加全部文件
git add .
# 提交代码
git commit -m "提交说明"
# 查看历史
git log --oneline
# 查看分支
git branch
# 创建并切换分支
git checkout -b feature-demo
# 切换分支
git checkout main
# 合并分支
git merge feature-demo
第六部分:新手常见问题与解决方法
1. AI 生成的代码可以直接用吗?
不建议完全不检查就使用。AI 生成的代码可能存在以下问题:
- 依赖版本不兼容
- 忽略异常处理
- 代码可以运行但逻辑不严谨
- 存在安全风险
- 使用了过时 API
- 没有考虑边界情况
正确做法是:先运行,再测试,再理解,最后修改。
2. 报错时该怎么办?
请按这个顺序处理:
- 复制完整报错信息;
- 确认当前所在目录;
- 检查依赖是否安装;
- 检查运行命令是否正确;
- 把报错、代码、目录结构一起发给 AI。
你可以问:
下面是我的报错信息和代码,请帮我分析错误原因,并给出一步步解决方案。
3. AI 写的代码太复杂怎么办?
你可以要求它简化:
这段代码对新手来说太复杂了,请用更简单的写法重写,并减少高级语法。
或者:
请保留相同功能,但用最基础的语法实现,方便初学者理解。
4. AI 总是答非所问怎么办?
你需要增加约束:
请不要使用框架,只使用原生 JavaScript。
请只输出完整代码,不要省略任何部分。
请按照我的项目结构修改,不要重新设计整个项目。
第七部分:推荐新手练习项目
以下项目非常适合用 AI 辅助完成:
Python 练习项目
- 命令行计算器
- 批量重命名文件工具
- Excel 数据清洗脚本
- 图片压缩工具
- 网页标题抓取器
- 文件夹自动分类工具
- 简单聊天机器人
- 天气查询命令行工具
JavaScript 练习项目
- 待办事项列表
- 计算器网页
- 倒计时工具
- 个人作品集网站
- 记账小应用
- Markdown 预览器
- 天气查询页面
- 简单博客前端页面
第八部分:一个完整 AI 编程实战流程示例
假设你要做一个“待办事项网页”,可以这样和 AI 配合。
第一步:提出需求
请帮我用 HTML、CSS、JavaScript 写一个待办事项网页。
要求:
1. 可以添加任务;
2. 可以删除任务;
3. 可以标记完成;
4. 数据保存在 localStorage;
5. 页面美观简洁;
6. 给出 index.html、style.css、script.js 三个完整文件代码;
7. 给出运行方式。
第二步:创建项目
mkdir todo-web
cd todo-web
touch index.html style.css script.js
Windows:
mkdir todo-web
cd todo-web
echo. > index.html
echo. > style.css
echo. > script.js
第三步:粘贴 AI 生成代码
将 AI 给出的代码分别复制到对应文件中。
第四步:运行项目
如果只是纯前端页面,可以直接双击 index.html 打开。
如果你安装了 VS Code,可以使用 Live Server 插件运行。
也可以用 Node.js 快速启动本地服务:
npx serve .
如果提示安装,输入 y 确认即可。
第五步:提交 Git
git init
git add .
git commit -m "完成待办事项网页初版"
第六步:继续优化
你可以继续问 AI:
请在现有待办事项网页基础上增加任务分类功能,包括工作、学习、生活三个分类。
或者:
请帮我优化页面样式,让它更像现代 Web App。
第九部分:AI 编程学习路线建议
对于零基础新手,可以按下面顺序学习:
第 1 阶段:基础操作
目标:能运行代码。
需要掌握:
- 命令行基础
- VS Code 使用
- Python 或 JavaScript 基础语法
- 如何安装依赖
- 如何运行文件
建议练习:
- 计算器
- 猜数字游戏
- 待办事项程序
第 2 阶段:小工具开发
目标:能做实用工具。
需要掌握:
- 文件读写
- 网络请求
- JSON 数据
- 错误处理
- 第三方库使用
建议练习:
- 批量重命名工具
- 天气查询工具
- Excel 处理脚本
- Markdown 转换工具
第 3 阶段:完整项目
目标:能完成一个可展示作品。
需要掌握:
- 项目结构
- 前后端基础
- 数据存储
- API 调用
- Git 管理
- 部署上线
建议练习:
- 个人博客
- 作品集网站
- 记账系统
- 简单后台管理页面
第 4 阶段:AI 深度协作
目标:让 AI 成为你的长期开发助手。
需要掌握:
- 高质量提示词
- 代码审查
- 自动化测试
- 项目重构
- 文档生成
- 部署运维基础
第十部分:给新手的关键建议
1. 不要追求一次生成完美项目
AI 生成大型项目时容易出错。更好的方式是:
先做小功能,再逐步扩展。
例如先做登录页面,再做注册,再做用户中心,不要一次要求 AI 写完整电商系统。
2. 每次只让 AI 修改一个明确问题
错误示例:
帮我优化整个项目。
更好的方式:
请只优化登录页面的表单校验逻辑,不要修改页面样式。
3. 学会保存可运行版本
每完成一个功能,就提交一次 Git:
git add .
git commit -m "完成登录功能"
这样即使 AI 后面把代码改坏,你也可以回到之前版本。
4. 不要把密钥直接发给 AI
如果你的项目中有 API Key、数据库密码、Token 等敏感信息,不要直接粘贴给 AI,也不要提交到 Git。
应该放在 .env 文件中,并加入 .gitignore:
.env
5. 必须学会阅读报错
报错不是敌人,而是线索。常见报错包括:
- 文件路径错误
- 依赖未安装
- 变量未定义
- 端口被占用
- 语法错误
- 版本不兼容
当你能看懂一部分报错时,AI 编程效率会明显提升。
总结
AI 编程极大降低了软件开发的门槛,但它并不是魔法。真正高效的方式是:你负责提出清晰需求、运行验证、判断结果;AI 负责生成代码、解释逻辑、辅助排错和优化方案。
对于新手来说,最推荐的路线是:
- 学会命令行和 VS Code;
- 选择 Python 或 JavaScript 入门;
- 用 AI 辅助完成小项目;
- 遇到报错时把完整信息交给 AI 分析;
- 学会 Git 保存版本;
- 不断让 AI 解释代码,而不是只复制粘贴;
- 从小工具逐渐过渡到完整项目。
最后记住一句话:
AI 不会替你成为程序员,但会让你更快成为程序员。
只要你愿意动手运行、不断提问、持续修改,AI 编程会成为你学习开发和提升效率的强大助力。