2026/3/3 1:48:41
网站建设
项目流程
一件代发50个货源网站,学做婴儿衣服网站好,品牌vi设计升级,加盟网络推广方案怎么写最近在整理自己的项目时#xff0c;想把本地的一个 Vue CLI 项目推送到 GitHub 上进行版本管理。本以为是个简单操作#xff0c;结果一路踩了几个典型的“新手坑”。今天就来记录一下整个过程#xff0c;希望能帮到和我一样刚接触 Git 和 GitHub 的朋友。
第一步#xff1…最近在整理自己的项目时想把本地的一个 Vue CLI 项目推送到 GitHub 上进行版本管理。本以为是个简单操作结果一路踩了几个典型的“新手坑”。今天就来记录一下整个过程希望能帮到和我一样刚接触 Git 和 GitHub 的朋友。第一步常规提交却报错 —— 没有配置远程仓库我一开始的操作非常“朴素”gitadd.gitcommit -minit projectgitpush结果控制台直接报错fatal: No configured push destination. Either specify the URL from the command-line or configure a remote repository using git remote add name url and then push using the remote name git push name原因分析这个错误的意思是——Git 不知道你要把代码推送到哪里。因为你还没有为本地仓库配置任何远程仓库地址remote。这就像你想寄快递但没填收件地址一样。解决方法需要先在 GitHub 上新建一个空仓库注意不要勾选 “Initialize this repository with a README”否则后续可能需要处理冲突然后在本地执行gitremoteaddorigin https://github.com/xuehao1997/vue-cli.git验证是否添加成功gitremote -v输出如下说明配置成功origin https://github.com/xuehao1997/vue-cli.git (fetch) origin https://github.com/xuehao1997/vue-cli.git (push)看起来一切正常于是继续推送gitpush -u origin master第二步认证失败 —— GitHub 已禁用密码登录然而又报错了remote: Invalid username or token. Password authentication is not supported for Git operations. fatal: Authentication failed for https://github.com/xuehao1997/vue-cli.git/原因分析从2021 年 8 月起GitHub 正式停止支持使用账号密码进行 Git 操作的认证方式。这意味着即使你输入正确的用户名和密码也会被拒绝。现在必须使用以下两种方式之一Personal Access Token (PAT)基于 HTTPSSSH 密钥基于 SSH 协议更安全且无需每次输入凭证我决定采用更推荐的SSH 方式。第三步配置 SSH 密钥1. 生成 SSH 密钥在终端执行ssh-keygen -t rsa -b4096-C743195023qq.com按回车使用默认路径~/.ssh/id_rsa也可以设置密码passphrase增强安全性可选。2. 查看公钥内容cat~/.ssh/id_rsa.pub你会看到类似这样的字符串ssh-rsa AAAAB3NzaC1yc2E... 743195023qq.com3. 将公钥添加到 GitHub打开 GitHub Settings进入SSH and GPG keys点击New SSH keyTitle 随便填比如 “My MacBook”把id_rsa.pub的全部内容粘贴进去点击Add SSH key4. 测试 SSH 连接ssh-T gitgithub.com如果看到Hi xuehao1997! Youve successfully authenticated, but GitHub does not provide shell access.恭喜SSH 认证成功 ✅第四步推送代码关键细节到这里很多人会以为要先把远程地址从 HTTPS 改成 SSHgitremote set-url origin gitgithub.com:xuehao1997/vue-cli.git但我发现即使没改也能推送成功这让我有点困惑。后来才明白其实是因为我之前没真正尝试过 HTTPS 推送因为认证失败了而 SSH 配置好后Git 在后台自动优先使用了 SSH 协议不过为了规范和避免未来混淆强烈建议显式将远程地址改为 SSH 格式gitremote set-url origin gitgithub.com:xuehao1997/vue-cli.git再检查一下gitremote -v# 应该显示# origin gitgithub.com:xuehao1997/vue-cli.git (fetch)# origin gitgithub.com:xuehao1997/vue-cli.git (push)最终推送gitpush -u origin master✅ 成功代码顺利上传到 GitHub。总结踩坑清单 最佳实践问题原因解决方案No configured push destination未设置远程仓库git remote add origin urlPassword authentication is not supportedGitHub 禁用密码认证改用 SSH 或 PAT推送失败/认证失败未配置 SSH 或 Token生成 SSH 密钥并添加到 GitHub地址混乱混用 HTTPS 和 SSH统一使用 SSH 地址建议新项目一律使用SSH 方式管理远程仓库一劳永逸。定期备份 SSH 私钥id_rsa文件但切勿泄露如果团队协作确保每个成员都配置好自己的 SSH。希望这篇记录能帮你少走弯路。Git 虽然强大但初学者很容易在“连接远程仓库”这一步卡住。只要理解背后的原理认证机制 远程地址配置就能从容应对。小贴士如果你还在用master分支注意 GitHub 默认分支现在是main。可以考虑统一使用main避免未来兼容问题。