球面坐标转直角坐标需确保角度为弧度制并采用物理惯例（r, θ, φ），公式为x = r·sinθ·cosφ、y = r·sinθ·sinφ、z = r·cosθ；直角转球面时用atan2(y,x)求φ，acos(z/r)前需clamp归一化，原点需特殊处理。
球面坐标转直角坐标：注意角度单位和坐标系定义
直接用 sin 和 cos 转换前，必须确认输入角度是弧度制——C++ 标准库的 sin、cos、tan 全部只接受弧度。若你手头是度数（比如 30°、45°），得先乘以 M_PI / 180.0 转换。
还要小心球面坐标的定义顺序：物理常用的是 (r, θ, φ)，其中 θ 是极角（与 z 轴夹角，范围 [0, π]），φ 是方位角（在 xy 平面内绕 z 轴，范围 [0, 2π)）；而数学或某些库可能反过来。一旦搞反，z 和 x/y 就会错位。
标准转换公式（按物理惯例）：
x = r * sin(θ) * cos(φ) y = r * sin(θ) * sin(φ) z = r * cos(θ)
实操建议：
- 用
#define _USE_MATH_DEFINES+#include <cmath></cmath>确保M_PI可用（Windows 下尤其必要） - 封装成函数时，显式命名参数，例如
to_cartesian(double r, double theta_rad, double phi_rad)，避免传参顺序歧义 - 对
r 的情况要决定策略：是拒绝（抛异常/断言），还是自动取绝对值并翻转方向？多数物理场景要求 <code>r ≥ 0
直角坐标转球面坐标：arctan2 是关键，别用 atan
从 (x, y, z) 算 φ 时，必须用 atan2(y, x)，不是 atan(y/x)。后者无法区分第二象限和第四象限（比如 (-1,1) 和 (1,-1) 算出来都是 -45°），还会在 x == 0 时除零。
θ 的计算看似简单：acos(z / r)，但有精度陷阱：当 r 接近 0 时，z/r 可能略大于 1 或小于 -1（浮点误差），导致 acos 返回 NaN。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
实操建议：
- 先算
r = sqrt(x*x + y*y + z*z)，再做归一化处理 - 对
z/r截断到 [-1.0, 1.0] 区间：std::clamp(z / r, -1.0, 1.0)（C++17 起）或手动判断 -
φ直接用atan2(y, x)，它天然处理所有象限和坐标轴情况 - 若需输出 [0, 2π) 范围的
φ，而atan2返回的是 [-π, π)，可加：phi += (phi
实际使用中容易崩的边界情况
三个最常出问题的输入组合，不加防护就会返回 NaN 或错误值：
-
(0, 0, 0)：原点 →r = 0，此时θ和φ数学上无定义，代码里应单独判断并设定默认值（如θ=0, φ=0） -
(0, 0, z)（z ≠ 0）：纯 z 轴 →φ无定义（xy 平面投影为原点），但atan2(0, 0)在多数实现中返回 0，可接受；重点检查θ是否为 0 或 π - 大数值或极小数值：比如
r = 1e200，平方后溢出double，建议先用hypot计算距离：r = hypot(hypot(x, y), z)，它更抗溢出
C++ 示例：一个轻量、带防护的转换结构体
下面是一个可直接粘贴使用的最小可行实现，覆盖了上述要点：
#include <cmath>
#include <algorithm> // for std::clamp
<p>struct Spherical {
double r, theta, phi; // theta ∈ [0,π], phi ∈ [0,2π)
};</p>
<p>struct Cartesian {
double x, y, z;
};</p>
<p>Spherical to_spherical(const Cartesian& c) {
const double r = std::hypot(std::hypot(c.x, c.y), c.z);
if (r == 0.0) return {0.0, 0.0, 0.0};</p>
<pre class="brush:php;toolbar:false;">const double theta = std::acos(std::clamp(c.z / r, -1.0, 1.0));
const double phi = std::atan2(c.y, c.x);
return {
r,
theta,
(phi <p>}</p><p>Cartesian to_cartesian(const Spherical& s) {
const double st = std::sin(s.theta);
return {
s.r <em> st </em> std::cos(s.phi),
s.r <em> st </em> std::sin(s.phi),
s.r * std::cos(s.theta)
};
}</p>
注意 std::hypot 比手动写 sqrt(x*x + y*y + z*z) 更安全；std::clamp 防止 acos 输入越界；phi 归一化到 [0, 2π) 是很多可视化或插值场景的实际需求。
真正麻烦的从来不是公式本身，而是浮点精度、坐标系约定、以及没人告诉你“原点该返回什么”。把这些兜住，转换才真的可靠。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
