网站代码部署的基本顺序是：先判断项目类型，再安装依赖并生成可发布文件，随后把文件上传到服务器，配置域名和运行环境，最后通过浏览器检查页面、接口和静态资源。静态网站通常只需要发布构建后的文件；带有后端、数据库或用户登录功能的网站，还需要启动服务、配置环境变量和反向代理。
网站代码部署前要准备什么？
先确认项目的技术类型和上线方式。打开项目根目录，查看是否存在 package.json、requirements.txt、pom.xml、Dockerfile 或类似配置文件。如果只有 HTML、CSS、JavaScript 和图片，通常属于静态网站；如果项目需要 Node.js、Java、Python、PHP 等程序持续运行，就属于动态网站。
- 静态网站：准备域名、服务器或静态托管空间，以及构建后的发布目录。
- 前端工程：准备对应版本的 Node.js、包管理器和生产环境配置。
- 后端网站：准备运行时、数据库、进程管理方式、端口和环境变量。
- 域名访问：准备域名解析权限，并确认服务器可以接收 80 和 443 端口的访问。
部署前还要检查配置文件。不要把本地地址、测试数据库密码或仅在本机有效的接口地址直接带到生产环境。将接口地址、数据库连接信息、密钥等内容放入服务器环境变量或独立配置文件，并根据项目要求填写正式值。
静态网站代码如何部署到服务器？
如果项目由 HTML、CSS 和 JavaScript 组成，可以按下面的顺序操作。每一步完成后都先确认结果，再进行下一步。
- 安装依赖。进入项目根目录，根据项目提供的说明执行安装命令。以常见前端项目为例，可使用 npm install 或项目指定的包管理器。安装完成后，应能看到依赖目录或锁定文件没有报错。
- 生成生产文件。执行项目定义的构建命令，常见命令是 npm run build。构建成功后，检查是否生成 dist、build 或其他发布目录。真正上传的是这个目录中的文件，而不是只上传源码目录。
- 创建网站目录。在服务器上为域名创建独立目录，例如网站根目录。将构建目录中的文件全部上传到根目录，确保入口文件通常为 index.html，而不是多套一层目录。
- 配置 Web 服务。在 Nginx、Apache 或服务器面板中，将域名指向网站根目录，并设置静态文件访问规则。保存配置后重新加载 Web 服务。
- 绑定域名。在域名解析平台添加指向服务器公网 IP 的记录。解析尚未生效时，可以先使用服务器 IP 或临时域名检查文件是否能被访问。
- 开启 HTTPS。为正式域名申请并配置证书，把 HTTP 请求跳转到 HTTPS。完成后分别打开首页、带参数页面和图片地址，确认浏览器没有证书或混合内容提示。
如果上传后首页能打开，但刷新二级路由出现 404，通常是前端路由没有配置回退规则。对于使用 History 路由的单页应用，需要让不存在的静态文件请求回到 index.html；如果项目使用 Hash 路由，则地址中通常会带有井号，服务器配置要求相对简单。
前端项目构建后，为什么不能直接上传源码？
开发目录中的源码可能包含未压缩文件、开发依赖、测试配置和本地路径。直接上传源码后，服务器不一定知道如何处理模块、预处理文件或开发路由。正确做法是先执行生产构建，再上传构建结果。
如果构建失败，先看终端最后一段报错，重点检查 Node.js 版本、依赖安装是否完整、环境变量是否缺失以及代码中的路径大小写。在本地构建成功后，再把同一份发布目录上传服务器。若服务器上的页面仍加载旧文件，可清理缓存或更换带版本号的静态资源文件名，然后重新加载页面。
带后端的网站代码如何部署？
动态网站不能只上传前端文件。它需要先准备运行环境，再启动后端服务，最后让 Web 服务器把域名请求转发给后端端口。推荐按照“数据库、后端、前端、域名”的顺序处理。
- 创建数据库。建立生产环境数据库和账号，设置最小必要权限。导入表结构和初始数据，记录数据库地址、端口、库名、用户名等配置。
- 上传后端代码。将后端代码放到独立目录，安装项目要求的运行依赖。不要把本地开发配置原样当作生产配置。
- 填写环境变量。配置数据库连接、服务端口、会话密钥、跨域地址、文件存储路径等参数。保存后先启动后端，并查看日志确认没有连接数据库或端口占用错误。
- 保持进程运行。使用项目适配的进程管理工具或容器，让服务在退出终端、系统重启后可以重新启动。直接在临时终端中运行，终端关闭后服务可能随之停止。
- 配置反向代理。将域名请求转发到后端监听的本机端口。外部用户访问域名时看到的是 Web 服务入口，后端端口不必直接暴露给公网。
- 发布前端并联调。前端接口地址必须指向正式域名或正式接口路径。打开登录、提交表单、文件上传等功能，确认请求状态码和返回内容正常。
例如，后端已经启动但域名访问失败时，先在服务器内部访问后端端口。如果本机访问正常而域名访问失败，问题通常位于反向代理、端口放行或域名配置；如果本机也无法访问，应先查看后端日志、环境变量和数据库连接。
部署客服弹窗或第三方服务代码时怎么处理？
如果网站需要在线客服、统计或其他第三方服务，先按照服务方提供的方式生成专属代码，再将代码放到指定页面位置。常见做法是把脚本放在页面底部，或放入前端项目的公共入口组件中；如果服务要求添加自定义按钮，则让按钮的点击事件调用服务方提供的打开方法。
代码加入后重新构建并部署，使用无痕窗口打开正式域名，检查按钮是否出现、弹窗是否能打开、移动端是否遮挡内容。若本地正常而线上不显示，应检查正式域名白名单、HTTPS、安全策略和脚本加载状态。不要把其他项目的服务代码或测试账号配置复制到当前网站。
网站部署后打不开，应该按什么顺序排查？
不要先反复上传文件。按照访问链路从外到内排查，可以更快定位问题。
- 域名没有解析：使用域名解析检查工具确认记录是否指向当前服务器 IP。记录刚修改时，部分网络可能仍保留旧缓存。
- 连接超时：检查服务器是否运行、80 和 443 端口是否放行，以及 Web 服务是否监听正确端口。
- 出现 403：检查网站根目录、文件权限和入口文件名称，确认 Web 服务账号能够读取文件。
- 出现 404：确认上传目录是否正确，域名是否指向了错误目录，并检查前端路由回退规则。
- 出现 502：通常表示反向代理找不到后端服务。检查后端进程、监听地址、端口和代理配置。
- 页面能开但功能失败：打开浏览器开发者工具，查看请求地址、状态码和响应内容，再核对跨域、接口路径、环境变量及数据库日志。
如果修改配置后仍然没有变化，先确认配置文件已经保存，再检查 Web 服务是否重新加载。随后清理浏览器缓存或使用无痕窗口测试，避免把旧页面误认为新部署结果。
如何确认网站已经完成部署？
部署完成不等于首页能打开。至少要从公开域名验证以下内容：访问首页和主要二级页面；刷新带路由的页面；检查 CSS、JavaScript、图片和字体是否加载；提交一次测试表单；验证登录、退出和权限控制；检查移动端布局；确认 HTTPS 生效且没有明显控制台错误。
如果网站使用后端，还要查看服务日志和数据库日志，确认请求确实到达新服务器。测试数据验证完成后应及时删除。最后记录本次部署的域名、代码版本、环境变量变更、数据库迁移结果和回滚方式。这样当新版本出现问题时，可以快速恢复上一份可用发布文件，而不必重新猜测部署过程。
ody5jj8oovq9rxqk976rjppuijtyzm0
